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++ 5.0 Learning Edition
- Microsoft Visual C++ 2.0 Professional Edition
- 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