FS_FindNextFile

FS_FindNextFile(
 PIOREQ pir
 )
 

A Win32 find next operation is performed through FS_FindNextFile. The find context handle created by FS_FindFirstFile is passed to continue the search. This routine handles the Win32 function: FindNextFile() and the int 21h function 714Fh.

ir_rh

Supplies handle to disk volume or network resource where the search is being done.

ir_fh

Supplies the find context handle obtained in a previous call to FS_FindFirstFile.

ir_data

Supplies a pointer to buffer where the find data for a file that is found is returned.

ir_sfn

Supplies system file number.

ir_options

Supplies options on the find next operation.

Find Next Option Values:
Value	Meaning
FILE_FIND_RESTART	Restart the find at the position designated by the find resume key passed in ir_pos. The operation of this key is described in greater detail below.

ir_pos

Supplies the find resume key. This parameter is passed in only if the FILE_FIND_RESTART option is specified.

ir_user

Supplies user ID for this request.

ir_pid

Supplies process ID for this request.

ir_error	Returns status of the operation ( 0 if no error, errorcode otherwise ).
ir_data	Returns find data for a file filled in the buffer in the following format if there was no error.

Find Data Structure:
Value	Meaning
dwFileAttributes	Returns the file attributes of the file found.

Attribute Values: Any valid combination of the following attributes may be returned.
Value	Meaning
FILE_ATTRIBUTE_READONLY	Read-Only file.
FILE_ATTRIBUTE_HIDDEN	Hidden file.
FILE_ATTRIBUTE_SYSTEM	System file.
FILE_ATTRIBUTE_DIRECTORY	Subdirectory.
FILE_ATTRIBUTE_ARCHIVE	Archive file.
FILE_ATTRIBUTE_VOLUMELABEL	Volume label found.

ftCreationTime

Returns the file creation time in the Win32 FileTime structure format.

Win32 FileTime Structure:
Value	Meaning
dwLowDateTime	Returns the low double word of the time in Win32 format.
dwHighDateTime	Returns the high double word of the time in Win32 format.

ftLastAccessTime	Returns the file last access time in Win32 FileTime structure format defined above.
ftLastWriteTime	Returns the file last write time in Win32 FileTime structure format defined above.
nFileSizeHigh	Returns the high 32-bits of the file size.
nFileSizeLow	Returns the low 32-bits of the file size.
cFileName	Returns the unicode long filename that was found.
CAlternateFileName	Returns the unicode alternate alias name (short file name) of the file that was found.

ir_pos

Returns the find resume key for this find next operation. The operation of this key is described above in the FS_FindFirstFile API documentation.