The FindFirstFileEx function searches a directory for a file whose name and attributes match those specified in the function call.
HANDLE FindFirstFileEx(
LPCTSTR lpFileName, |
// pointer to the name of the file to search for |
FINDEX_INFO_LEVELS fInfoLevelId, |
// information level of the returned data |
LPVOID lpFindFileData, |
// pointer to the returned information |
FINDEX_SEARCH_OPS fSearchOp, |
// type of filtering to perform |
LPVOID lpSearchFilter, |
// pointer to search criteria |
DWORD dwAdditionalFlags |
// additional search control flags |
); |
If the function succeeds, the return value is a search handle that can be used in a subsequent call to the FindNextFile or FindClose functions.
If the function fails, the return value is INVALID_HANDLE_VALUE. To get extended error information, call GetLastError.
The FindFirstFileEx function is provided to open a search handle and return information about the first file whose name matches the specified pattern and attributes.
If the underlying file system does not support the specified type of filtering, other than directory filtering, FindFirstFileEx fails with the error ERROR_NOT_SUPPORTED. The application has to use FINDEX_SEARCH_OPS type FileExSearchNameMatch and perform its own filtering.
Once established, the search handle can be used in the FindNextFile function to search for other files that match the same pattern with the same filtering being performed. When the search handle is no longer needed, it should be closed using the FindClose function.
The call
FindFirstFileEx( lpFileName, FindExInfoStandard, lpFindData, FindExSearchNameMatch, NULL, 0 );
is equivalent to the call
FindFirstFile( lpFileName, lpFindData);
FINDEX_INFO_LEVELS, FINDEX_SEARCH_OPS, FindFirstFile, FindNextFile, FindClose
file: /Techref/os/win/api/win32/func/src/f24_11.htm, 5KB, , updated: 2000/4/7 12:19, local time: 2024/9/3 17:41,
18.190.153.24:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://sxlist.com/Techref/os/win/api/win32/func/src/f24_11.htm"> FindFirstFileEx</A> |
Did you find what you needed? |
Welcome to sxlist.com!sales, advertizing, & kind contributors just like you! Please don't rip/copy (here's why Copies of the site on CD are available at minimal cost. |
Welcome to sxlist.com! |
.