Struct winver::WindowsVersion

pub struct WindowsVersion {
    pub major: u32,
    pub minor: u32,
    pub build: u32,
}

Windows OS version.

This type implements Eq and Ord so you can easily compare two versions.

assert!(WindowsVersion::new(10, 0, 1000) < WindowsVersion::new(10, 0, 2000));

This type provides four methods to detect the OS version.

• WindowsVersion::from_ntdll_dll
• WindowsVersion::from_wmi_os_provider
• WindowsVersion::from_kernel32_dll
• WindowsVersion::from_get_version_ex

Fields

major: u32

Major version of Windows OS.

minor: u32

Minor version of Windows OS.

build: u32

Build number of Windows OS.

Implementations

impl WindowsVersion

pub fn from_ntdll_dll() -> Result<Self, Error>

Detect the OS version of current Windows system using RtlGetVersion function in ntdll.dll DLL.

The obtained version is accurate. And this method is faster than WindowsVersion::from_wmi_os_provider. However ntdll.dll does not always exist in your system and RtlGetVersion is a kernel-mode function.

This method loads ntdll.dll dynamically and tries to call RtlGetVersion function in it. When the dynamic call fails, this method returns an error.

pub fn from_wmi_os_provider() -> Result<Self, Error>

Detect the OS version of current Windows system using WMI’s Win32_OperatingSystem provider via WQL.

The obtained version is accurate. However WMI may not be available due to the process security level setting. When it is not possible to access the provider, this method returns an error.

pub fn from_kernel32_dll() -> Result<Self, Error>

Detect the OS version of current Windows system from kernel32.dll file’s version information.

The version actually represents the OS version where the kernel32.dll file was built. The build number may be slightly different from the actual OS version. This method should be used as fallback of other methods.

This method was implemented referring to Python’s sys.getwindowsversion implementation.

pub fn from_get_version_ex() -> Result<Self, Error>

Detect the OS version of current Windows system using GetVersionEx Win32 API.

You need to embed a compatibility manifest into your executable. Otherwise, this method always returns version 6.2 (Windows 8) even if you’re on Windows 10 or later. So this method should be used as fallback of other methods.

This behavior is a limitation of the GetVersionEx function. Please read the Remarks section of VerifyVersionInfo document.

pub fn detect() -> Option<Self>

Return the OS version of the current Windows system. This method tries to get the version with the following steps. When no version could not be detected on all steps, this method returns None.

1. Try to detect the OS version with WindowsVersion::from_ntdll_dll
2. Try to detect the OS version with WindowsVersion::from_wmi_os_provider
3. Try to detect the OS version with WindowsVersion::from_kernel32_dll
4. Try to detect the OS version with WindowsVersion::from_get_version_ex

impl WindowsVersion

pub fn new(major: u32, minor: u32, build: u32) -> Self

Create WindowsVersion instance with the major, minor, and build numbers.

Trait Implementations

impl Clone for WindowsVersion

fn clone(&self) -> WindowsVersion

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for WindowsVersion

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

Formats the value using the given formatter.

impl Display for WindowsVersion

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

Formats the value using the given formatter.

impl Hash for WindowsVersion

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for WindowsVersion

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<WindowsVersion> for WindowsVersion

fn eq(&self, other: &WindowsVersion) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<WindowsVersion> for WindowsVersion

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for WindowsVersion

impl StructuralEq for WindowsVersion

impl StructuralPartialEq for WindowsVersion