|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
_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 );
- Search handle returned by a previous call to _findfirst.
- File information buffer.
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|
|_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.
All versions of the C run-time libraries.