Microsoft KB Archive/131945

= 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</li></ul>

 Microsoft Visual C++ 4.0 Professional Edition</li></ul>

 Microsoft Visual C++ 4.1 Subscription</li></ul> </li></ul>

-

<div class="notice_section">

This article was previously published under Q131945

<div class="symptoms_section">

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.

<div class="status_section">

STATUS
<div class="moreinformation_section">

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

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.