Struct SecurityDescriptor 

pub struct SecurityDescriptor { /* private fields */ }

An owned, self-relative copy of a caller’s security descriptor.

Whatever form the caller supplied, this holds the self-relative form in one contiguous, DWORD-aligned blob, so it names nothing outside itself and can be carried to another thread.

Implementations

impl SecurityDescriptor

pub unsafe fn capture( descriptor: *const c_void, ) -> Result<Self, SecurityCaptureError>

Captures the descriptor at descriptor.

An absolute descriptor is converted to self-relative form; a self-relative one is copied as it stands. Either way the result owns every byte it refers to.

Errors

Returns a SecurityCaptureError when Windows rejects the descriptor as malformed, or when the conversion fails.

Safety

descriptor must be non-null and point to a security descriptor that stays valid for the duration of this call, including everything an absolute descriptor points at.

pub fn as_ptr(&self) -> *const c_void

The captured descriptor’s address, for handing to a Win32 call.

The pointer borrows from this value and must not outlive it.

pub fn len(&self) -> usize

The captured descriptor’s length in bytes.

pub fn is_empty(&self) -> bool

Whether the captured descriptor is empty, which a valid one never is.

pub fn as_bytes(&self) -> &[u8]

The captured descriptor’s bytes.

pub fn dacl(&self) -> Result<AclState, SecurityCaptureError>

What the descriptor says about its discretionary access-control list.

Errors

Returns a SecurityCaptureError if Windows will not report the list, which a descriptor that validated at capture should not do.

pub fn sacl(&self) -> Result<AclState, SecurityCaptureError>

What the descriptor says about its system access-control list.

Errors

As dacl.

Trait Implementations

impl Clone for SecurityDescriptor

fn clone(&self) -> SecurityDescriptor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SecurityDescriptor

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

Formats the value using the given formatter.

impl Eq for SecurityDescriptor

impl PartialEq for SecurityDescriptor

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SecurityDescriptor