Struct SecDesc 

pub struct SecDesc { /* private fields */ }

A validated, portable representation of a self-relative Windows security descriptor.

A descriptor tracks which components were loaded through its mask, so partial security queries can be carried without pretending that omitted components were absent on the target. Use SecDescUpdate with with to make a checked update.

Implementations

impl SecDesc

pub fn new( mask: SecInfo, rm_control: u8, control: SecDescControl, owner: Option<Sid>, group: Option<Sid>, dacl: Option<AclBuf>, sacl: Option<AclBuf>, ) -> Result<Self, SecDescError>

Creates a security descriptor from its structural components.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, SecDescError>

Parses a self-relative Windows security descriptor packet.

pub fn from_bytes_with_mask( bytes: &[u8], mask: SecInfo, ) -> Result<Self, SecDescError>

Parses the selected components of a self-relative Windows security descriptor packet.

pub fn to_bytes(&self) -> Vec<u8>

Converts this descriptor to a canonical self-relative Windows packet.

pub const fn mask(&self) -> SecInfo

Returns the native SECURITY_INFORMATION mask associated with the descriptor.

pub const fn revision(&self) -> SecDescRevision

Returns the security descriptor revision.

pub const fn control(&self) -> SecDescControl

Returns the security descriptor control mask.

pub const fn rm_control(&self) -> Option<u8>

Returns the resource-manager control byte when it is valid.

pub const fn rm_control_valid(&self) -> bool

Returns whether the resource-manager control byte is valid.

pub const fn owner_loaded(&self) -> bool

Returns whether the owner component was loaded.

pub const fn owner(&self) -> Option<&Sid>

Returns the owner SID, if present.

pub const fn owner_defaulted(&self) -> bool

Returns whether the owner SID was supplied by a default mechanism.

pub const fn group_loaded(&self) -> bool

Returns whether the group component was loaded.

pub const fn group(&self) -> Option<&Sid>

Returns the primary group SID, if present.

pub const fn group_defaulted(&self) -> bool

Returns whether the group SID was supplied by a default mechanism.

pub const fn dacl_loaded(&self) -> bool

Returns whether the DACL component was loaded.

pub fn dacl(&self) -> Option<&Acl>

Returns the DACL, if it is non-null.

pub const fn dacl_present(&self) -> bool

Returns whether the descriptor marks the DACL as present.

pub const fn dacl_defaulted(&self) -> bool

Returns whether the DACL was supplied by a default mechanism.

pub const fn dacl_auto_inherit_required(&self) -> bool

Returns whether DACL inheritance computation was requested.

pub const fn dacl_auto_inherited(&self) -> bool

Returns whether the DACL was produced through inheritance.

pub const fn dacl_protected(&self) -> bool

Returns whether the DACL is protected from inheritance.

pub const fn sacl_loaded(&self) -> bool

Returns whether the SACL component was loaded.

pub fn sacl(&self) -> Option<&Acl>

Returns the SACL, if it is non-null.

pub const fn sacl_present(&self) -> bool

Returns whether the descriptor marks the SACL as present.

pub const fn sacl_defaulted(&self) -> bool

Returns whether the SACL was supplied by a default mechanism.

pub const fn sacl_auto_inherit_required(&self) -> bool

Returns whether SACL inheritance computation was requested.

pub const fn sacl_auto_inherited(&self) -> bool

Returns whether the SACL was produced through inheritance.

pub const fn sacl_protected(&self) -> bool

Returns whether the SACL is protected from inheritance.

pub fn with(&self, update: SecDescUpdate) -> Result<Self, SecDescError>

Returns a new descriptor with the supplied component and control updates.

Trait Implementations

impl Clone for SecDesc

fn clone(&self) -> SecDesc

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SecDesc

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SecDesc

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SecDesc

impl PartialEq for SecDesc

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SecDesc

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SecDesc