BY_HANDLE_FILE_INFORMATION

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.

Members

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.

See Also

GetFileInformationByHandle