Struct Acl

pub struct Acl { /* private fields */ }

The ACL structure is the header of an access control list (ACL). A complete ACL consists of an ACL structure followed by an ordered list of zero or more access control entries (ACEs).

https://learn.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-acl

Implementations

impl Acl

pub fn acl_revision(&self) -> &AclRevision

Specifies the revision level of the ACL. This value should be ACL_REVISION, unless the ACL contains an object-specific ACE, in which case this value must be ACL_REVISION_DS. All ACEs in an ACL must be at the same revision level.

pub fn acl_size(&self) -> &u16

Specifies the size, in bytes, of the ACL. This value includes the ACL structure, all the ACEs, and the potential unused memory.

pub fn ace_count(&self) -> &u16

Specifies the number of ACEs stored in the ACL.

pub fn ace_list(&self) -> &Vec<Ace>

pub fn acl_type(&self) -> &AclType

pub fn control_flags(&self) -> &ControlFlags

impl Acl

pub fn new( acl_revision: AclRevision, acl_type: AclType, control_flags: ControlFlags, ace_list: Vec<Ace>, ) -> Self

pub fn from_sddl(value: &str, domain_rid: Option<&[u32]>) -> Result<Self, Error>

parses an SDDL string

Example

use sddl::{Acl, AclType};
let acl = Acl::from_sddl("D:P(A;CIOI;GRGX;;;BU)(A;CIOI;GA;;;BA)(A;CIOI;GA;;;SY)(A;CIOI;GA;;;CO)", None).unwrap();
 
assert_eq!(*acl.acl_type(), AclType::DACL);
assert_eq!(*acl.ace_count(), 4);

pub fn sddl_string(&self) -> String

Trait Implementations

impl BinRead for Acl

type Args<'__binrw_generated_args_lifetime> = (ControlFlags, AclType)

The type used for the args parameter of read_args() and read_options().

fn read_options<R: Read + Seek>( __binrw_generated_var_reader: &mut R, __binrw_generated_var_endian: Endian, __binrw_generated_var_arguments: Self::Args<'_>, ) -> BinResult<Self>

Read Self from the reader using the given Endian and arguments.

fn read_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek, Self: ReadEndian,

Read Self from the reader using the given arguments.

fn read_be_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek,

Read Self from the reader, assuming big-endian byte order, using the given arguments.

fn read_le_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek,

Read Self from the reader, assuming little-endian byte order, using the given arguments.

fn read_ne_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek,

Read T from the reader, assuming native-endian byte order, using the given arguments.

impl BinWrite for Acl

type Args<'__binrw_generated_args_lifetime> = (ControlFlags, AclType)

The type used for the args parameter of write_args() and write_options().

fn write_options<W: Write + Seek>( &self, __binrw_generated_var_writer: &mut W, __binrw_generated_var_endian: Endian, __binrw_generated_var_arguments: Self::Args<'_>, ) -> BinResult<()>

Write Self to the writer using the given Endian and arguments.

fn write_args<W>( &self, writer: &mut W, args: Self::Args<'_>, ) -> Result<(), Error>

where W: Write + Seek, Self: WriteEndian,

Write Self to the writer using the given arguments.

fn write_be_args<W>( &self, writer: &mut W, args: Self::Args<'_>, ) -> Result<(), Error>

where W: Write + Seek,

Write Self to the writer, assuming big-endian byte order, using the given arguments.

fn write_le_args<W>( &self, writer: &mut W, args: Self::Args<'_>, ) -> Result<(), Error>

where W: Write + Seek,

Write Self to the writer, assuming little-endian byte order, using the given arguments.

impl Debug for Acl

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

Formats the value using the given formatter.

impl Display for Acl

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

https://learn.microsoft.com/de-de/windows/win32/secauthz/security-descriptor-string-format

impl PartialEq for Acl

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ReadEndian for Acl

const ENDIAN: EndianKind = _

The endianness of the type.

impl WriteEndian for Acl

const ENDIAN: EndianKind = _

The endianness of the type.

impl Eq for Acl