DOC: CFileDialog::DoModal Does Not Return 0

• The Microsoft Foundation Classes (MFC) included with: - Microsoft Visual C++, 32-bit Edition, versions 2.0, 2.1, 2.2, 4.0,

       4.1, 4.2, 5.0
  

SUMMARY

The documentation for the Class Library Reference distributed with Visual C++ is incorrect. The documentation states:

   IDOK or IDCANCEL if the function is successful; otherwise 0. IDOK and
   IDCANCEL are constants that indicate whether the user selected the OK or
   Cancel button.

   If IDCANCEL is returned, you can call the Windows CommDlgExtendedError
   function to determine whether an error occurred.

   IDOK or IDCANCEL. If IDCANCEL is returned, you can call the Windows
   CommDlgExtendedError function to determine whether an error occurred.

   IDOK and IDCANCEL are constants that indicate whether the user selected
   the OK or Cancel button.

MORE INFORMATION

This correction applies to the documentation for the following MFC common dialog classes: CFileDialog, CColorDialog, CFontDialog, CPageSetupDialog, CPrintDialog, and CFindReplaceDialog.

Note that 0 is not a legitimate return value for the MFC common dialog DoModal member function.