_findnext, _findnext64, _findnexti64, _wfindnext, _wfindnext64, _wfindnexti64
div
TOC
Collapse the table of content
Expand the table of content
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 
);

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

Show:
© 2016 Microsoft