Rust bindings to MS Windows Registry API. Work in progress.
Currently it can:
* open registry key
* create key
* query key metadata
* delete key
* delete key recursively
* read String
from REG_SZ
, REG_EXPAND_SZ
or REG_MULTI_SZ
value
* read u32
from REG_DWORD
value
* read u64
from REG_QWORD
value
* read raw value of any type to RegValue
structure
* write String
and &str
into REG_SZ
value
* write u32
into REG_DWORD
value
* write u64
into REG_QWORD
value
* write raw value of any type from RegValue
structure
* iterate through subkey names
* iterate through values
Basic usage: ```rust extern crate winreg; use std::path::Path; use winreg::RegKey; use winreg::enums::*;
fn main() { println!("Reading some system info..."); let hklm = RegKey::predef(HKEYLOCALMACHINE); let curver = hklm.opensubkeywithflags("SOFTWARE\Microsoft\Windows\CurrentVersion", KEYREAD).unwrap(); let pf: String = curver.getvalue("ProgramFilesDir").unwrap(); let dp: String = curver.getvalue("DevicePath").unwrap(); println!("ProgramFiles = {}\nDevicePath = {}", pf, dp); let info = curver.query_info().unwrap(); 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 = hkcu.create_subkey(&path).unwrap();
key.set_value("TestSZ", &"written by Rust").unwrap();
let sz_val: String = key.get_value("TestSZ").unwrap();
key.delete_value("TestSZ").unwrap();
println!("TestSZ = {}", sz_val);
key.set_value("TestDWORD", &1234567890u32).unwrap();
let dword_val: u32 = key.get_value("TestDWORD").unwrap();
println!("TestDWORD = {}", dword_val);
key.set_value("TestQWORD", &1234567891011121314u64).unwrap();
let qword_val: u64 = key.get_value("TestQWORD").unwrap();
println!("TestQWORD = {}", qword_val);
key.create_subkey("sub\\key").unwrap();
hkcu.delete_subkey_all(&path).unwrap();
println!("Trying to open nonexisting key...");
println!("{:?}", hkcu.open_subkey(&path).unwrap_err());
} ```
Iterators: ```rust extern crate winreg; use winreg::RegKey; use winreg::enums::*;
fn main() { println!("File extensions, registered in system:"); for i in RegKey::predef(HKEYCLASSESROOT) .enumkeys().map(|x| x.unwrap()) .filter(|x| x.startswith(".")) { println!("{}", i); }
let system = RegKey::predef(HKEY_LOCAL_MACHINE)
.open_subkey_with_flags("HARDWARE\\DESCRIPTION\\System", KEY_READ)
.unwrap();
for (name, value) in system.enum_values().map(|x| x.unwrap()) {
println!("{} = {:?}", name, value);
}
} ```