This function continues a file search from a previous call to the FindFirstFile function.

A remote application interface (RAPI) version of this function exists and it is named CeFindNextFile.

BOOL FindNextFile( 
HANDLE hFindFile, 
LPWIN32_FIND_DATA lpFindFileData ); 


  • hFindFile
    [in] Search handle returned by a previous call to the FindFirstFile function.
  • lpFindFileData
    [out] Pointer to the WIN32_FIND_DATA structure that receives information about the found file or subdirectory. The structure can be used in subsequent calls to FindNextFile to refer to the found file or directory.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError. If no matching files can be found, the GetLastError function returns ERROR_NO_MORE_FILES.


The FindNextFile function searches for files by name only; it cannot be used for attribute-based searches.


Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Winbase.h   Coredll.lib, Fsmain.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

FindClose, FindFirstFile, GetFileAttributes, GetLastError, SetFileAttributes, WIN32_FIND_DATA

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.