[−][src]Crate winreg
Crate for accessing MS Windows registry
Usage
Basic usage
# Cargo.toml
[dependencies]
winreg = "0.6"
extern crate winreg; use std::path::Path; use std::io; use winreg::RegKey; use winreg::enums::*; fn main() -> io::Result<()> { println!("Reading some system info..."); let hklm = RegKey::predef(HKEY_LOCAL_MACHINE); let cur_ver = hklm.open_subkey("SOFTWARE\\Microsoft\\Windows\\CurrentVersion")?; let pf: String = cur_ver.get_value("ProgramFilesDir")?; let dp: String = cur_ver.get_value("DevicePath")?; println!("ProgramFiles = {}\nDevicePath = {}", pf, dp); let info = cur_ver.query_info()?; println!("info = {:?}", info); println!("And now lets write something..."); let hkcu = RegKey::predef(HKEY_CURRENT_USER); let path = Path::new("Software").join("WinregRsExample1"); let (key, disp) = hkcu.create_subkey(&path)?; match disp { REG_CREATED_NEW_KEY => println!("A new key has been created"), REG_OPENED_EXISTING_KEY => println!("An existing key has been opened") } key.set_value("TestSZ", &"written by Rust")?; let sz_val: String = key.get_value("TestSZ")?; key.delete_value("TestSZ")?; println!("TestSZ = {}", sz_val); key.set_value("TestDWORD", &1234567890u32)?; let dword_val: u32 = key.get_value("TestDWORD")?; println!("TestDWORD = {}", dword_val); key.set_value("TestQWORD", &1234567891011121314u64)?; let qword_val: u64 = key.get_value("TestQWORD")?; println!("TestQWORD = {}", qword_val); key.create_subkey("sub\\key")?; hkcu.delete_subkey_all(&path)?; println!("Trying to open nonexistent key..."); hkcu.open_subkey(&path) .unwrap_or_else(|e| match e.kind() { io::ErrorKind::NotFound => panic!("Key doesn't exist"), io::ErrorKind::PermissionDenied => panic!("Access denied"), _ => panic!("{:?}", e) }); Ok(()) }
Iterators
extern crate winreg; use std::io; use winreg::RegKey; use winreg::enums::*; fn main() -> io::Result<()> { println!("File extensions, registered in system:"); for i in RegKey::predef(HKEY_CLASSES_ROOT) .enum_keys().map(|x| x.unwrap()) .filter(|x| x.starts_with(".")) { println!("{}", i); } let system = RegKey::predef(HKEY_LOCAL_MACHINE) .open_subkey("HARDWARE\\DESCRIPTION\\System")?; for (name, value) in system.enum_values().map(|x| x.unwrap()) { println!("{} = {:?}", name, value); } Ok(()) }
Modules
enums |
|
transaction |
Structure for a registry transaction.
Part of |
types |
Traits for loading/saving Registry values |
Structs
EnumKeys |
Iterator over subkeys names |
EnumValues |
Iterator over values |
RegKey |
Handle of opened registry key |
RegKeyMetadata |
Metadata returned by |
RegValue |
Raw registry value |
Type Definitions
HKEY |