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

ID: Q131945

The information in this article applies to:

The Microsoft Foundation Classes (MFC) included with: - Microsoft Visual C++ for Windows, versions 1.5, 1.51, 1.52 - Microsoft Visual C++, 32-bit Edition, versions 1.0, 2.0, 2.1,
```
     4.0, 4.1
```

SUMMARY

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.

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          : kbdocfix kbdocerr kbFileIO kbMFC kbVC kbVC420fix kbVC500fix 
Version           : 1.0 1.5 1.51 1.52 2.0 2.1 4.0 4.
Platform          : NT WINDOWS

Last Reviewed: May 24, 1998