RtlGetVersion - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
#ifndef _NTRTL_H

NTSYSAPI
NTSTATUS
NTAPI
RtlGetVersion(
    _Out_ PVOID VersionInformation
    );

#endif

View code on GitHub
// wdm.h

NTSYSAPI NTSTATUS RtlGetVersion(
  [out] PRTL_OSVERSIONINFOW lpVersionInformation
);
View the official Windows Driver Kit DDI reference
// ntddk.h

NTSTATUS RtlGetVersion(
  _Out_ PRTL_OSVERSIONINFOW lpVersionInformation
);
View the official Win32 development documentation

NtDoc

This function is documented in Windows Driver Kit.

Windows Driver Kit DDI reference (nf-wdm-rtlgetversion)

RtlGetVersion function

Description

The RtlGetVersion routine returns version information about the currently running operating system.

Parameters

lpVersionInformation [out]

Pointer to either a RTL_OSVERSIONINFOW structure or a RTL_OSVERSIONINFOEXW structure that contains the version information about the currently running operating system. A caller specifies which input structure is used by setting the dwOSVersionInfoSize member of the structure to the size in bytes of the structure that is used.

Return value

RtlGetVersion returns STATUS_SUCCESS.

Remarks

RtlGetVersion is the kernel-mode equivalent of the user-mode GetVersionEx function in the Windows SDK. See the example in the Windows SDK that shows how to get the system version.

When using RtlGetVersion to determine whether a particular version of the operating system is running, a caller should check for version numbers that are greater than or equal to the required version number. This ensures that a version test succeeds for later versions of Windows.

Because operating system features can be added in a redistributable DLL, checking only the major and minor version numbers is not the most reliable way to verify the presence of a specific system feature. A driver should use RtlVerifyVersionInfo to test for the presence of a specific system feature.

See also

PsGetVersion


Win32 development documentation (rtlgetversion)

RtlGetVersion function

Gets version information about the currently running operating system.

Parameters

lpVersionInformation [out]

Pointer to either a RTL_OSVERSIONINFOW structure or a RTL_OSVERSIONINFOEXW structure that contains the version information about the currently running operating system. A caller specifies which input structure is used by setting the dwOSVersionInfoSize member of the structure to the size in bytes of the structure that is used.

Return value

Returns STATUS_SUCCESS.

Remarks

RtlGetVersion is the equivalent of the GetVersionEx function in the Windows SDK. See the example in the Windows SDK that shows how to get the system version.

When using RtlGetVersion to determine whether a particular version of the operating system is running, a caller should check for version numbers that are greater than or equal to the required version number. This ensures that a version test succeeds for later versions of Windows.

Because operating system features can be added in a redistributable DLL, checking only the major and minor version numbers is not the most reliable way to verify the presence of a specific system feature. A driver should use RtlVerifyVersionInfo to test for the presence of a specific system feature.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Target platform
Universal
Header
Ntddk.h (include Ntddk.h)
Library
Ntdll.lib;
NtosKrnl.lib
DLL
Ntdll.dll;
NtosKrnl.exe

See also

PsGetVersion