FIX: CFileDialog::DoModal Does Not Return 0 (162160)



The information in this article applies to:

  • The Microsoft Foundation Classes (MFC), when used with:
    • Microsoft Visual C++, 32-bit Editions 2.0
    • Microsoft Visual C++, 32-bit Editions 2.1
    • Microsoft Visual C++, 32-bit Editions 2.2
    • Microsoft Visual C++, 32-bit Editions 4.0
    • Microsoft Visual C++, 32-bit Editions 4.1
    • Microsoft Visual C++, 32-bit Enterprise Edition 4.2
    • Microsoft Visual C++, 32-bit Professional Edition 4.2
    • Microsoft Visual C++, 32-bit Enterprise Edition 5.0
    • Microsoft Visual C++, 32-bit Professional Edition 5.0

This article was previously published under Q162160

SYMPTOMS

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.

The corrected documentation should read:

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.

STATUS

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

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.

Modification Type:MajorLast Reviewed:12/10/2003
Keywords:kbBug kbCmnDlg kbdocerr kbDocs kbfix kbNoUpdate kbui KbUIDesign kbVC600fix KB162160