FIX: OnFileNameOK Returns 0 if Valid or 1 if Not Valid (131945)



The information in this article applies to:

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

This article was previously published under Q131945

SYMPTOMS

The following incorrect text appears in the online documentation for the function CFileDialog::OnFileNameOK() and in Books Online:

Return Value
Nonzero if the filename is a valid filename, otherwise 0.

It should be:

Return Value
1 if the filename is NOT a valid filename, otherwise 0.

STATUS

MORE INFORMATION

CFileDialog::OnFilenameOK() is a virtual function that can be overridden to handle the private message FILEOKSTRING. When handling this message, the MFC common dialog hook function calls OnFileNameOK() and returns to the common dialog procedure whatever the virtual function returns. The dialog procedure in COMDLG32.DLL (or COMMDLG.DLL in 16-bit programs) dismisses the dialog if the return from the hook function is 0 (zero) and keeps the dialog displayed if the return value is 1 (one). Other nonzero return values are currently reserved and should not be used.

This documentation error was corrected in Visual C++ 32-bit Edition version 4.2.

Modification Type:MajorLast Reviewed:12/1/2003
Keywords:kbBug kbdocerr kbdocfix kbFileIO kbfix kbVC420fix KB131945