FindNextFile function

STDCALL BOOL FindNextFile(HANDLE SearchHandle, LPWIN32_FIND_DATA FileData);

Searches for the next file matching the pattern of a search inititated with FindFirstFile.

• Returns TRUE on success or FALSE on failure, in which case GetLastError can be used to retrieve error information (returns ERROR_NO_MORE_FILES if no more matching files exist), the FileData structure will not be filled, and the search handle should be closed.

SearchHandle

Gives the handle (returned by a call to FindFirstFile) identifying the search.

FileData

Points to the WIN32_FIND_DATA structure (WIN32_FIND_DATAA for Ansi implementation or WIN32_FIND_DATAW for Unicode) to recieve information about the found file. Microsoft documentation makes it unclear whether the structure needs to be the same on entry as it was when returned by FindFirstFile or whether a different memory location may be used (I suggest the latter is most likely).