Struct QueryVolumeInformation 

pub struct QueryVolumeInformation { /* private fields */ }

An owned, marshalable parameter set for GetVolumeInformationByHandleW.

Example

use std::fs;
use std::os::windows::io::AsHandle;

use windows_namespace_request_sys::volume::QueryVolumeInformation;
use windows_namespace_request_sys::CapturedHandle;

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

let volume = QueryVolumeInformation::new(CapturedHandle::capture(file.as_handle())?)
    .perform()?;

// A real volume names its filesystem and reports a component limit.
assert!(!volume.filesystem_name().is_empty());
assert!(volume.maximum_component_length() > 0);

Implementations

impl QueryVolumeInformation

pub fn new(handle: CapturedHandle) -> Self

Begins a request against handle.

The handle names any file or directory on the volume; the volume is what gets reported.

pub fn handle(&self) -> &CapturedHandle

The owned duplicate of the handle being queried.

pub fn try_clone(&self) -> Result<Self, HandleCaptureError>

Copies the request, duplicating the handle.

Errors

Returns the handle-capture failure when the handle cannot be duplicated.

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

Performs the query on the calling thread.

Errors

Returns the raw Win32 code, unaltered.

Trait Implementations

impl Debug for QueryVolumeInformation

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

Formats the value using the given formatter.

impl Request for QueryVolumeInformation

type Error = Win32Error

How performing it can fail.

type Output = VolumeInformation

What performing the request produces.

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

Performs the request on the calling thread.