FIX: CFileDialog::DoModal Does Not Return 0

• The Microsoft Foundation Classes (MFC), included with:
  • Microsoft Visual C++, 32-bit Editions, 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: 0 is not a legitimate return value for the MFC common dialog DoModal member function.

STATUS

This problem was corrected in the documentation for Visual C++, version 6.0.

Additional query words: CfileDialog CColorDialog CfontDialog CPageSetupDialog CPrintDialog CFindReplaceDialog

Keywords : kbui kbdocerr kbMFC kbDocs KbUIDesign kbVC kbVC200bug kbVC210bug kbVC220bug kbVC400bug kbVC410bug kbVC420bug kbVC500bug kbVC600fix
Version :
Platform : NT WINDOWS
Issue type : kbbug