RtlGetVersion 函式

取得目前執行中作業系統的版本資訊。

語法

NTSTATUS RtlGetVersion(
  _Out_ PRTL_OSVERSIONINFOW lpVersionInformation
);

參數

lpVersionInformation [out]

RTL_OSVERSIONINFOW結構的指標或包含目前執行中作業系統版本資訊的RTL_OSVERSIONINFOEXW結構。 呼叫端會藉由將結構的 dwOSVersionInfoSize 成員設定為所使用結構位元組的大小，來指定使用哪一個輸入結構。

傳回值

傳回STATUS_SUCCESS。

備註

RtlGetVersion 相當於 Windows SDK 中的 GetVersionEx 函 式。 請參閱 Windows SDK 中的範例，其中顯示如何取得系統版本。

使用 RtlGetVersion 來判斷作業系統的特定版本是否正在執行時，呼叫端應該檢查大於或等於所需版本號碼的版本號碼。 這可確保更新版本的 Windows 版本測試成功。

由於作業系統功能可以新增至可轉散發 DLL 中，因此只檢查主要和次要版本號碼，並不是驗證特定系統功能是否存在的最可靠方式。 驅動程式應該使用 RtlVerifyVersionInfo 來測試特定系統功能是否存在。

規格需求

需求 值
最低支援的用戶端
 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限桌面應用程式]
目標平台
普遍
標頭
Ntddk.h (包含 Ntddk.h)
程式庫
Ntdll.lib;
NtosKrnl.lib
DLL
Ntdll.dll;
NtosKrnl.exe

另請參閱

PsGetVersion

 

 

  • Last updated on