Export (0) Print
Expand All
div
Expand Minimize
0 out of 2 rated this helpful - Rate this topic

_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

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.