Article ID: 166505
Article Last Modified on 11/21/2006
APPLIES TO
- Microsoft Foundation Class Library 4.2, when used with:
- Microsoft Visual C++ 4.2 Enterprise Edition
- Microsoft Visual C++ 5.0 Enterprise Edition
- Microsoft Visual C++ 6.0 Enterprise Edition
- Microsoft Visual C++ 4.2 Professional Edition
- Microsoft Visual C++ 5.0 Professional Edition
- Microsoft Visual C++ 6.0 Professional Edition
- Microsoft Visual C++ 6.0 Standard Edition
This article was previously published under Q166505
SUMMARY
The documentation for CFileFind::FindNextFile, CFtpFileFind::FindNextFile, and CGopherFileFind::FindNextFile in the Class Library Reference with Visual C++ is incorrect. The documentation states:
Return Value Nonzero if successful; otherwise 0. To get extended error information, call the Win32 function GetLastError.
The documentation should read:
Return Value Nonzero if there are more files; zero if the file found is the last one in the directory or if an error occurred. To get extended error information, call the Win32 function GetLastError. If the file found is the last file in the directory, or if no matching files can be found, the GetLastError function returns ERROR_NO_MORE_FILES.
MORE INFORMATION
The code below shows how to use CFileFind::FindNextFile to find every file in a directory.
Sample Code
CFileFind finder; BOOL bWorking = finder.FindFile("*.*"); while (bWorking) { bWorking = finder.FindNextFile(); // Do processing here }
REFERENCES
See the CFileFind overview in the Visual C++ documentation.
Additional query words: FindNextFile FileFind CfileFind CftpFileFind CGopherFileFind
Keywords: kbbug kbdocerr kbdocfix kbfileio kbnoupdate kbpending kbusage KB166505