Struct SecurityDescriptor

#[repr(C)]
pub struct SecurityDescriptor { /* private fields */ }

A Windows security descriptor.

This can only be accessed through a pointer, never constructed directly.

See MSDN for details.

Implementations

impl SecurityDescriptor

pub fn as_sddl(&self) -> Result<OsString>

Get the Security Descriptor Definition Language (SDDL) string corresponding to this SecurityDescriptor

This function attempts to get the entire SDDL string using SecurityInformation::all(). To get a portion of the SDDL, use wrappers::ConvertSecurityDescriptorToStringSecurityDescriptor directly.

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

Get the owner SID if it exists

use windows_permissions::{LocalBox, SecurityDescriptor, Sid};

let sd1: LocalBox<SecurityDescriptor> = "O:S-1-5-10-20".parse().unwrap();
let sd2: LocalBox<SecurityDescriptor> = "G:S-1-5-10-20".parse().unwrap();

assert_eq!(sd1.owner().unwrap(),
    &*Sid::new([0, 0, 0, 0, 0, 5], &[10, 20]).unwrap());
assert_eq!(sd2.owner(), None);

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

Get the group SID if it exists

use windows_permissions::{LocalBox, SecurityDescriptor, Sid};

let sd1: LocalBox<SecurityDescriptor> = "G:S-1-5-10-20".parse().unwrap();
let sd2: LocalBox<SecurityDescriptor> = "O:S-1-5-10-20".parse().unwrap();

assert_eq!(sd1.group().unwrap(),
    &*Sid::new([0, 0, 0, 0, 0, 5], &[10, 20]).unwrap());
assert_eq!(sd2.group(), None);

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

Get the DACL if it exists

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

Get the SACL if it exists

Trait Implementations

impl Debug for SecurityDescriptor

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

Formats the value using the given formatter.

impl Drop for SecurityDescriptor

fn drop(&mut self)

Executes the destructor for this type.