windows-permissions 0.2.4

Safe Rust bindings to Windows permissions APIs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

use crate::Acl;
use std::io;
use winapi::um::winnt::ACL_SIZE_INFORMATION;

/// Wraps [`GetAclInformation`](https://docs.microsoft.com/en-us/windows/win32/api/securitybaseapi/nf-securitybaseapi-getaclinformation)
///
/// Always uses [`ACL_SIZE_INFORMATION`](https://docs.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-acl_size_information) as the information class.
#[allow(non_snake_case)]
pub fn GetAclInformationSize(acl: &Acl) -> io::Result<ACL_SIZE_INFORMATION> {
    debug_assert!(crate::wrappers::IsValidAcl(acl));

    let mut info = ACL_SIZE_INFORMATION {
        AceCount: 0xDEADBEEF,
        AclBytesInUse: 0xDEADBEEF,
        AclBytesFree: 0xDEADBEEF,
    };

    let info_size = std::mem::size_of::<ACL_SIZE_INFORMATION>() as u32;

    let result = unsafe {
        winapi::um::securitybaseapi::GetAclInformation(
            acl as *const _ as *mut _,
            &mut info as *mut _ as *mut _,
            info_size,
            winapi::um::winnt::AclSizeInformation,
        )
    };

    if result == 0 {
        Err(io::Error::last_os_error())
    } else {
        debug_assert!(info.AceCount != 0xDEADBEEF);
        debug_assert!(info.AclBytesInUse != 0xDEADBEEF);
        debug_assert!(info.AclBytesFree != 0xDEADBEEF);
        Ok(info)
    }
}