FindFirstFile function

STDCALL HANDLE FindFirstFile(LPCSTR FName, LPWIN32_FIND_DATA FileData);

Searches for the first file whose name matches the specified specification or name. Wildcard characters ('*' and '?') are allowed in the specification.

• Returns a HANDLE which can be used to continue (see FindNextFile) or finish the search, or INVALID_HANDLE_VALUE (in which case further information can be found by calling GetLastError, and the FileData structure will not be filled). When finished with a handle, an application should use FindClose to close the handle.

FName

A pointer to the filename specification to search for. The size limit of this string is MAX_PATH characters. The limit can be avoided by using the Wide character (Unicode) version of the function and prepending '\\?\' to the path. According to Microsoft documentation, UNC (network) paths must be given the form '\\?\UNC\(server)\(path)' to work correctly this way. It is not known whether the 'UNC\' format is also required for UNC paths without the '\\?\' extension.

FileData

Points to a WIN32_FIND_DATA structure (which becomes WIN32_FIND_DATA<x> where <x> is 'A' for Ansi or 'W' for Unicode versions respectively) which will be filled with information about the found file.