_findnext, __wfindnext

From RAD Studio
Jump to: navigation, search

Go Up to io.h Index


Header File

io.h, wchar.h

Category

Directory Control Routines

Prototype

long _findnext(long handle, struct _finddata_t *fileinfo);

long __wfindnext(long handle, struct _wfinddata_t *fileinfo);

Description

Finds subsequent files, if any, that match the filter argument in a previous call to _findfirst/__wfindfirst. Then, _findnext/__wfindnext updates the fileinfo structure with the necessary information for continuing the search. One file name for each call to _tfindnext is returned until no more files are found in the directory matching the pathname (filter).

The handle parameter is the search handle returned by a previous call to _findfirst. The fileinfo parameter is the file information buffer.

These functions are provided for Microsoft compatibility.

Return Value

On success, returns 0.

Otherwise, returns –1 and sets errno to:

ENOENTFile specification that could not be matched

Portability

POSIX Win32 ANSI C ANSI C++
_findnext +
__wfindnext NT only

See Also