Microsoft KB Archive/131945

From BetaArchive Wiki
Knowledge Base


FIX: OnFileNameOK Returns 0 if Valid or 1 if Not Valid

Article ID: 131945

Article Last Modified on 11/21/2006



APPLIES TO

  • Microsoft Foundation Class Library 4.2, when used with:
    • Microsoft Visual C++ 6.1
    • Microsoft Visual C++ 5.0 Learning Edition
    • Microsoft Visual C++ 2.0 Professional Edition
    • Microsoft Visual C++ 2.1
    • Microsoft Visual C++ 4.0 Professional Edition
    • Microsoft Visual C++ 4.1 Subscription



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.


Additional query words: kbVC400bug 2.50 2.51 3.00 3.10 4.20

Keywords: kbbug kbdocerr kbdocfix kbfileio kbfix kbvc420fix KB131945