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. |