Struct QueryFileInformationByHandle 

pub struct QueryFileInformationByHandle { /* private fields */ }

An owned, marshalable parameter set for GetFileInformationByHandle.

Example

use std::fs;

use windows_namespace_request_sys::file_info::QueryFileInformationByHandle;

let path = std::env::temp_dir().join(format!("wnrs-fi-{}.tmp", std::process::id()));
fs::write(&path, b"example")?;
let file = fs::File::open(&path)?;

let information = QueryFileInformationByHandle::new(file).perform()?;

// The 64-bit file index this call reports in one shot, which the Ex form's
// FileIdInfo does not give in this shape.
let index = (u64::from(information.nFileIndexHigh) << 32)
    | u64::from(information.nFileIndexLow);
assert_ne!(index, 0);
assert_eq!(information.nFileSizeLow, b"example".len() as u32);

Implementations

impl QueryFileInformationByHandle

pub fn new(handle: impl Into<SharedHandle>) -> Self

Begins a request against handle, which the request holds as one more holder of it.

pub fn handle(&self) -> &SharedHandle

The handle being queried, shared with its other holders.

pub fn perform(&self) -> Outcome<BY_HANDLE_FILE_INFORMATION>

Performs the query on the calling thread.

Errors

Returns the raw Win32 code, unaltered.

Trait Implementations

impl Clone for QueryFileInformationByHandle

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryFileInformationByHandle

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

Formats the value using the given formatter.

impl Request for QueryFileInformationByHandle

type Error = Win32Error

How performing it can fail.

type Output = BY_HANDLE_FILE_INFORMATION

What performing the request produces.

fn perform(&self) -> Outcome<BY_HANDLE_FILE_INFORMATION>

Performs the request on the calling thread.