Struct FileInformationClass 

pub struct FileInformationClass(/* private fields */);

Which information the query asks for.

A newtype over FILE_INFO_BY_HANDLE_CLASS rather than an enum, because Windows defines classes this crate has never heard of and refusing them would narrow the entry. The named constants are the five the audit found; any other class reaches Windows unaltered through from_raw.

Example

use windows_namespace_request_sys::query::FileInformationClass;
use windows_sys::Win32::Storage::FileSystem::{FileBasicInfo, FileStandardInfo};

assert_eq!(FileInformationClass::BASIC.as_raw(), FileBasicInfo);

// A class with no named constant here is still expressible.
let standard = FileInformationClass::from_raw(FileStandardInfo);
assert_eq!(standard.as_raw(), FileStandardInfo);

Implementations

impl FileInformationClass

pub const BASIC: Self

FileBasicInfo: timestamps and attributes. A pure read.

pub const ID: Self

FileIdInfo: the volume serial and 128-bit file id. A pure read.

pub const CASE_SENSITIVE: Self

FileCaseSensitiveInfo: whether the directory is case-sensitive. A pure read.

pub const ID_EXTD_DIRECTORY: Self

FileIdExtdDirectoryInfo: the next batch of directory entries.

Advances the enumeration cursor, which lives in the file object and is therefore shared with every duplicate of the handle.

pub const ID_EXTD_DIRECTORY_RESTART: Self

FileIdExtdDirectoryRestartInfo: the first batch, restarting the enumeration.

Resets the enumeration cursor, with the same sharing consequence.

pub const fn from_raw(class: FILE_INFO_BY_HANDLE_CLASS) -> Self

Wraps a raw FILE_INFO_BY_HANDLE_CLASS.

pub const fn as_raw(self) -> FILE_INFO_BY_HANDLE_CLASS

The raw class value.

pub const fn moves_enumeration_cursor(self) -> bool

Whether this class mutates the handle’s shared enumeration cursor.

True only for the two directory-enumeration classes. Every other class is a pure read that composes freely with an enumeration in progress, measured rather than assumed.

An unrecognised class reports false, because this answers “is this one of the two known cursor-moving classes”, not “is this provably safe”.

Example

use windows_namespace_request_sys::query::FileInformationClass;

assert!(FileInformationClass::ID_EXTD_DIRECTORY.moves_enumeration_cursor());
assert!(FileInformationClass::ID_EXTD_DIRECTORY_RESTART.moves_enumeration_cursor());

// Interleaving one of these with an enumeration is safe: measured, not
// reasoned from the object model.
assert!(!FileInformationClass::BASIC.moves_enumeration_cursor());
assert!(!FileInformationClass::ID.moves_enumeration_cursor());

Trait Implementations

impl Clone for FileInformationClass

fn clone(&self) -> FileInformationClass

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for FileInformationClass

impl Debug for FileInformationClass

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for FileInformationClass

impl Hash for FileInformationClass

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FileInformationClass

fn eq(&self, other: &FileInformationClass) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FileInformationClass