Struct VirtualRegistry 

pub struct VirtualRegistry { /* private fields */ }

In-memory Windows registry tree. Keys are referenced by their full path ("HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft"). Each key holds a set of named values; the value names are matched case-insensitively per the Win32 contract.

The handle space is local to the registry; opened keys return synthetic HKEY values starting at HKEY_USER_BASE. The four predefined hive roots (HKEY_LOCAL_MACHINE, HKEY_CURRENT_USER, HKEY_CLASSES_ROOT, HKEY_USERS) live at HKLM / HKCU / HKCR / HKU respectively.

Implementations

impl VirtualRegistry

pub fn new() -> Self

pub fn set_value(&mut self, key_path: &str, name: &str, value: RegistryValue)

Set a value on a key, creating the key if absent.

pub fn get_value(&self, key_path: &str, name: &str) -> Option<&RegistryValue>

Read a value by (key, name). Case-insensitive.

pub fn all_values(&self) -> impl Iterator<Item = (&str, &str, &RegistryValue)>

Iterate every (key_path, value_name, value) triple in the virtual registry. Suitable for “what did the guest write?” reports.

pub fn contains_key(&self, key_path: &str) -> bool

True iff the named key exists.

pub fn predefined_path(hkey: u32) -> Option<&'static str>

Resolve a predefined hive handle to its canonical path string.

pub fn open_key(&mut self, base_hkey: u32, subkey: &str) -> Option<u32>

Open a subkey under base_hkey (which may be a predefined hive or a previously-returned user handle). Returns None if the key doesn’t exist.

pub fn close_key(&mut self, hkey: u32) -> bool

Close a previously-opened handle. Predefined hives (HKLM etc.) are tolerated — the call is a no-op. Returns true if the handle was a user handle that was closed.

pub fn owns(&self, hkey: u32) -> bool

True iff hkey was minted by this registry (and still open). Used by the Win32 stubs to disambiguate registry handles from VFS / heap / event handles when CloseHandle is called.

pub fn path_of(&self, hkey: u32) -> Option<&str>

Map an open handle back to its canonical key path. Returns None if hkey isn’t known.

Trait Implementations

impl Clone for VirtualRegistry

fn clone(&self) -> VirtualRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VirtualRegistry

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

Formats the value using the given formatter.

impl Default for VirtualRegistry

fn default() -> VirtualRegistry

Returns the “default value” for a type.