Rust crate to detect real OS version on Windows
MIT License
winver
cratewinver
is a tiny Rust crate to detect real Windows OS version depending on windows
crate only.
use winver::WindowsVersion;
let version = WindowsVersion::detect().unwrap();
if version >= WindowsVersion::new(10, 0, 15063) {
println!("OS version is 10.0.15063 or later: {}", version);
}
There are several ways to get Windows OS version and each of them has its pitfall. This crate provides API to get the version more easily and safely avoiding the pitfalls.
The above WindowsVersion::detect
function works as follows:
RtlGetVersion
function in ntdll.dll. However it is a kernel mode function andWin32_OperatingSystem
provider via WQL. WMI may not be availableGetVersionExW
function as fallback. This is an official way to get OS version but itNone
.Each steps are implemented as isolated funcitons in WindowsVersion
. For example, the step 1. is equivalent to
WindowsVersion::from_ntdll_dll
.
This logic was implemented referring to the implementation of Python's sys.getwindowsversion
and
platform.win32_ver
.
See the API documentation for more details.
Add the following lines to your project's Cargo.toml. Note that winver
crate is available only on Windows.
[target."cfg(windows)".dependencies]
winver = "1"
Minimum supported Rust version is 1.65.0 for using let-else statement.
Distributed under the MIT license.