windows-erg 0.1.0

Ergonomic, idiomatic Rust wrappers for Windows 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
38
39
40
41
42
43
44
45

//! Security target helpers.

use crate::Result;

use super::SecurityDescriptor;
use super::backends;

/// Permission target reference.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum PermissionTarget {
    /// File or directory path.
    FilePath(String),
    /// Registry key path.
    RegistryPath(String),
}

impl PermissionTarget {
    /// Build a file target.
    pub fn file(path: impl Into<String>) -> Self {
        PermissionTarget::FilePath(path.into())
    }

    /// Build a registry target.
    pub fn registry(path: impl Into<String>) -> Self {
        PermissionTarget::RegistryPath(path.into())
    }

    /// Read current descriptor for target.
    pub fn read_descriptor(&self) -> Result<SecurityDescriptor> {
        match self {
            PermissionTarget::FilePath(path) => backends::file::read_descriptor(path),
            PermissionTarget::RegistryPath(path) => backends::registry::read_descriptor(path),
        }
    }

    /// Write descriptor to target.
    pub fn write_descriptor(&self, descriptor: &SecurityDescriptor) -> Result<()> {
        match self {
            PermissionTarget::FilePath(path) => backends::file::write_descriptor(path, descriptor),
            PermissionTarget::RegistryPath(path) => {
                backends::registry::write_descriptor(path, descriptor)
            }
        }
    }
}