Skip to main content

Module file_basic

Module file_basic 

Source
Expand description

The FileBasicInfo class of GetFileInformationByHandleEx, read as a typed value.

QueryFileInformation makes the same call for every class and returns the bytes it wrote. For this class the bytes are a FILE_BASIC_INFO, and reading one out of them needs unsafe, so a consumer that forbids it cannot. This entry makes the call with a FILE_BASIC_INFO as the buffer and returns its five fields as values. It is still one Win32 call: a typed reading of one class, not a second operation, shaped as QueryFileIdInfo is (D-33 in the crate’s design notes).

§What the values are, and what they are not

The FILE_BASIC_INFO page gives the four times “in FILETIME format, which is a 64-bit value representing the number of 100-nanosecond intervals since January 1, 1601 (UTC)”, and the attributes as the file attribute constants. All five are carried as the call wrote them: the times as i64, the attributes as their raw u32. Nothing here converts a time, names an attribute, or says what either means beyond the page.

Structs§

FileBasicInfo
The four times and the attributes FileBasicInfo reports, as the call wrote them.
QueryFileBasicInfo
An owned, marshalable parameter set for GetFileInformationByHandleEx with FileBasicInfo.