Enum Hive

#[non_exhaustive]
pub enum Hive {
    ClassesRoot,
    CurrentConfig,
    CurrentUser,
    CurrentUserLocalSettings,
    LocalMachine,
    PerformanceData,
    Users,
}

All hives of the Windows Registry. Start here to get to a registry key.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ClassesRoot

CurrentConfig

CurrentUser

CurrentUserLocalSettings

LocalMachine

PerformanceData

Users

Implementations

impl Hive

pub fn open<P>(&self, path: P, sec: Security) -> Result<RegKey, Error>

where P: TryInto<U16CString>, P::Error: Into<Error>,

pub fn write<P>(&self, file_path: P) -> Result<(), Error>

where P: TryInto<U16CString>, P::Error: Into<Error>,

pub fn create<P>(&self, path: P, sec: Security) -> Result<RegKey, Error>

where P: TryInto<U16CString>, P::Error: Into<Error>,

pub fn delete<P>(&self, path: P, is_recursive: bool) -> Result<(), Error>

where P: TryInto<U16CString>, P::Error: Into<Error>,

pub fn load_file<P: AsRef<Path>>( file_path: P, sec: Security, ) -> Result<RegKey, Error>

Examples found in repository

examples/appkey.rs (lines 6-9)

fn main() -> Result<(), std::io::Error> {
    let hive_key = Hive::load_file(
        Path::new(r"C:\Users\Default\NTUSER.DAT"),
        Security::Read | Security::Write,
    )
    .unwrap();

    walk_keys(hive_key, 0);
    Ok(())
}

examples/private-hive.rs (lines 10-13)

fn main() -> Result<(), windows::core::Error> {
    let mut token = HANDLE::default();
    unsafe { OpenProcessToken(GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES, &mut token)? };

    set_privilege(token, SE_RESTORE_NAME)?;
    set_privilege(token, SE_BACKUP_NAME)?;
    let hive_key = Hive::load_file(
        r"C:\Users\Default\NTUSER.DAT",
        Security::Read | Security::Write,
    )
    .unwrap();

    let keys: Vec<_> = hive_key.keys().map(|k| k.unwrap().to_string()).collect();

    println!("{:?}", keys);
    Ok(())
}

Trait Implementations

impl Clone for Hive

fn clone(&self) -> Hive

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Hive

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

Formats the value using the given formatter.

impl Display for Hive

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

Formats the value using the given formatter.

impl Copy for Hive