typedef struct _BY_HANDLE_FILE_INFORMATION { /* bhfi */
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD dwVolumeSerialNumber;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
DWORD nNumberOfLinks;
DWORD nFileIndexHigh;
DWORD nFileIndexLow;
} BY_HANDLE_FILE_INFORMATION,
*PBY_HANDLE_FILE_INFORMATION, *LPBY_HANDLE_FILE_INFORMATION;
The BY_HANDLE_FILE_INFORMATION structure contains information returned by the GetFileInformationByHandle function.
dwFileAttributes
Returns the files attributes.
ftCreationTime
Returns the files create time (or zero if the underlying file system does not support this).
ftLastAccessTime
Returns the files last access time (or zero if the underlying file system does not support this).
ftLastWriteTime
Returns the last write time for the file.
dwVolumeSerialNumber
Returns the volume serial number of the volume that contains the file.
nFileSizeHigh
Returns the high order 32-bits of the files size.
nFileSizeLow
Returns the low order 32-bits of the files size.
nNumberOfLinks
Returns the number of links to this file. For FAT and HPFS file systems the value returned here is 1. For NTFS, this may be more than one.
nFileIndexHigh
Supplies the high order 32-bits of a unique id associated with the file.
nFileIndexLow
Supplies the low order 32-bits of a unique id associated with the file. The unique ID (along with the volume serial number) uniquely identifies a file. This number may change across re-boots and on different opens of a file. If a file is opened (by any process), the number is constant. Applications are expected to use this value when they have two handles and want to know if the handles refer to the same file.
GetFileInformationByHandle