Enum SecurityCaptureFailure 

#[non_exhaustive]
pub enum SecurityCaptureFailure {
    InvalidDescriptor,
    ReadControl,
    SizeSelfRelative,
    MakeSelfRelative,
    SizeAbsolute,
    MakeAbsolute,
    InvalidCopy,
    ReadAcl,
    Allocate,
    InvalidSddl,
    InteriorNul,
    ToSddl,
    ReadSecurity,
    UnsupportedObjectType,
}

Why a caller’s security attributes could not be captured.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidDescriptor

Windows rejected the descriptor as malformed.

Reported at construction, on the calling thread, rather than left for the eventual call to fail with it on a worker.

ReadControl

Windows could not report the descriptor’s control flags, so whether it was absolute or self-relative could not be established.

SizeSelfRelative

Windows could not size the self-relative form of an absolute descriptor.

MakeSelfRelative

Windows could not convert an absolute descriptor to self-relative form.

SizeAbsolute

Windows could not size the absolute form of a self-relative descriptor.

MakeAbsolute

Windows could not take a self-relative descriptor apart into absolute form.

InvalidCopy

The captured copy did not validate, which would mean the conversion produced something Windows will not accept later.

ReadAcl

Windows could not report the descriptor’s DACL or SACL.

Allocate

The memory for the owned copy could not be allocated.

The error’s code is ERROR_NOT_ENOUGH_MEMORY, which this crate supplies; no Win32 call produced it.

InvalidSddl

Windows refused an SDDL string. The error’s code is Windows’ own.

InteriorNul

An SDDL string contained an interior NUL, which Windows would read as its end. Refused before any call is made; the error’s code is ERROR_INVALID_PARAMETER, which this crate supplies.

ToSddl

Windows refused to write a descriptor as SDDL. The error’s code is Windows’ own.

ReadSecurity

Windows refused to read the security of an object by its handle. The error’s code is Windows’ own.

UnsupportedObjectType

get_security_info was given an object kind it does not pass with a handle of any kind. Refused before any call is made, as this crate’s own narrowing; the error’s code is ERROR_INVALID_PARAMETER, which this crate supplies.

Trait Implementations

impl Clone for SecurityCaptureFailure

fn clone(&self) -> SecurityCaptureFailure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SecurityCaptureFailure

impl Debug for SecurityCaptureFailure

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

Formats the value using the given formatter.

impl Eq for SecurityCaptureFailure

impl Hash for SecurityCaptureFailure

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

where __H: Hasher,

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 SecurityCaptureFailure

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SecurityCaptureFailure