_findnext, _findnext64, _findnexti64, _wfindnext, _wfindnext64, _wfindnexti64
Find the next name, if any, that matches the filespec argument in a previous call to _findfirst, and then alter the fileinfo structure contents accordingly.
int _findnext( intptr_t handle, struct _finddata_t *fileinfo ); int _findnext64( intptr_t handle, struct __finddata64_t *fileinfo ); int _findnexti64( intptr_t handle, struct _finddatai64_t *fileinfo ); int _wfindnext( intptr_t handle, struct _wfinddata_t *fileinfo ); int _wfindnext64( intptr_t handle, struct __wfinddata64_t *fileinfo ); int _wfindnexti64( intptr_t handle, struct _wfinddatai64_t *fileinfo );
Parameters
- handle
- Search handle returned by a previous call to _findfirst.
- fileinfo
- File information buffer.
Return Value
If successful, return 0. Otherwise, return –1 and sets errno to ENOENT, indicating that no more matching files could be found.
_findnext64, which uses the __finddata64_t structure, and _wfindnext64, which use the __wfinddata64_t structure, allow file-creation dates to be expressed up through 23:59:59, December 31, 3000, UTC, whereas the other functions only represent dates through 19:14:07 January 18, 2038, UTC. Midnight, January 1, 1970, is the lower bound of the date range for all these functions.
You must call _findclose after you are finished using either the _findfirst or _findnext function. This will free up resources used by these functions in your application.
Generic-Text Routine Mappings
| TCHAR.H routine | _UNICODE & _MBCS not defined | _MBCS defined | _UNICODE defined |
|---|---|---|---|
| _tfindnext | _findnext | _findnext | _wfindnext |
| _tfindnext64 | _findnext64 | _findnext64 | _wfindnext64 |
| _tfindnexti64 | _findnexti64 | _findnexti64 | _wfindnexti64 |
Requirements
| Function | Required header | Compatibility |
|---|---|---|
| _findnext | <io.h> | Win 98, Win Me, Win NT, Win 2000, Win XP |
| _findnext64 | <io.h> | Win 98, Win Me, Win NT, Win 2000, Win XP |
| _findnexti64 | <io.h> | Win 98, Win Me, Win NT, Win 2000, Win XP |
| _wfindnext | <io.h> or <wchar.h> | Win NT, Win 2000, Win XP |
| _wfindnext64 | <io.h> or <wchar.h> | Win NT, Win 2000, Win XP |
| _wfindnexti64 | <io.h> or <wchar.h> | Win NT, Win 2000, Win XP |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
All versions of the C run-time libraries.
See Also
System Calls Routines | _find, _wfind Function Overview | Run-Time Routines and .NET Framework Equivalents
