firehazard 0.0.0-2022-09-10

Unopinionated low level API bindings focused on soundness, safety, and stronger types over raw FFI.
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

use crate::*;
use winapi::um::minwinbase::SECURITY_ATTRIBUTES;
use core::marker::PhantomData;
use core::mem::size_of;
use core::ptr::null;



/// \[[docs.microsoft.com](https://docs.microsoft.com/en-us/previous-versions/windows/desktop/legacy/aa379560(v=vs.85))\]
/// SECURITY_ATTRIBUTES
#[derive(Clone, Copy, Default)]
#[repr(transparent)] pub struct Attributes<'sd> {
    attributes:  SECURITY_ATTRIBUTES,
    phantom:     PhantomData<security::Descriptor<'sd>>,
}

impl<'sd> Attributes<'sd> {
    pub fn new(security_descriptor: Option<&'sd security::Descriptor<'sd>>, inherit_handle: bool) -> Self {
        let security_descriptor = security_descriptor.map_or(null(), |d| d);
        Self {
            attributes: SECURITY_ATTRIBUTES {
                nLength:                size_of::<SECURITY_ATTRIBUTES>() as _,
                lpSecurityDescriptor:   security_descriptor as *mut _,
                bInheritHandle:         inherit_handle as _,
            },
            phantom: PhantomData
        }
    }

    pub fn inherit_handle(&self) -> bool { self.attributes.bInheritHandle != 0 }
    pub fn set_inherit_handle(&mut self, inherit: bool) { self.attributes.bInheritHandle = inherit as _ }

    pub fn security_descriptor(&self) -> Option<&'sd security::Descriptor<'sd>> {
        if self.attributes.lpSecurityDescriptor.is_null() { return None }
        Some(unsafe { core::mem::transmute(self.attributes.lpSecurityDescriptor) })
    }

    pub fn set_security_descriptor(&mut self, sd: Option<&'sd security::Descriptor<'sd>>) {
        let sd = sd.map_or(null(), |d| d);
        self.attributes.lpSecurityDescriptor = sd as *mut _;
    }

    pub fn with_security_descriptor<'d>(self, sd: Option<&'d security::Descriptor<'d>>) -> Attributes<'d> where 'sd: 'd {
        let mut a : Attributes<'d> = self;
        a.set_security_descriptor(sd);
        a
    }
}

impl From<&    Attributes<'_>> for *const SECURITY_ATTRIBUTES { fn from(a: &    Attributes) -> Self { &    a.attributes } }
impl From<&mut Attributes<'_>> for *mut   SECURITY_ATTRIBUTES { fn from(a: &mut Attributes) -> Self { &mut a.attributes } }

impl<'sd> From<(       &'sd security::Descriptor<'sd> , bool)> for Attributes<'sd> { fn from((desc, inherit): (       &'sd security::Descriptor<'sd> , bool)) -> Self { Self::new(Some(desc), inherit) } }
impl<'sd> From<(Option<&'sd security::Descriptor<'sd>>, bool)> for Attributes<'sd> { fn from((desc, inherit): (Option<&'sd security::Descriptor<'sd>>, bool)) -> Self { Self::new(desc, inherit) } }

// Debug? Default?