Share via

VerSetConditionMask 函式 (winnt.h)

  • 發行項

設定 64 位值的位，以指出要用於指定作業系統版本屬性的比較運算元。 此函式用來建置 VerifyVersionInfo 函式的 dwlConditionMask 參數。

語法

NTSYSAPI ULONGLONG VerSetConditionMask(
  [in] ULONGLONG ConditionMask,
  [in] DWORD     TypeMask,
  [in] BYTE      Condition
);

參數

[in] ConditionMask

要傳遞為 VerifyVersionInfo 函式之 dwlConditionMask 參數的值。 函式會將比較資訊儲存在此變數的位中。

在第一次呼叫 VerSetCondition 之前，請將此變數初始化為零。 針對後續呼叫，傳入先前呼叫中使用的變數。

[in] TypeMask

遮罩，指出正在設定比較運算子的 OSVERSIONINFOEX 結構成員。 這個值對應於 VerifyVersionInfo 函式之 dwTypeMask 參數中指定的其中一個位。 此參數可以是下列其中一個值。

值 意義
VER_BUILDNUMBER
0x0000004
 dwBuildNumber
VER_MAJORVERSION
0x0000002
 dwMajorVersion
VER_MINORVERSION
0x0000001
 dwMinorVersion
VER_PLATFORMID
0x0000008
 dwPlatformId
VER_PRODUCT_TYPE
0x0000080
 wProductType
VER_SERVICEPACKMAJOR
0x0000020
 wServicePackMajor
VER_SERVICEPACKMINOR
0x0000010
 wServicePackMinor
VER_SUITENAME
0x0000040
 wSuiteMask

[in] Condition

要用於比較的運算符。 VerifyVersionInfo 函式會使用此運算符，將指定的屬性值與目前執行中系統的對應值進行比較。

對於 VER_SUITENAME 以外的 dwTypeBitMask 所有值，此參數可以是下列其中一個值。

值 意義
VER_EQUAL
1
 目前的值必須等於指定的值。
VER_GREATER
2
 目前的值必須大於指定的值。
VER_GREATER_EQUAL
3
 目前的值必須大於或等於指定的值。
VER_LESS
4
 目前的值必須小於指定的值。
VER_LESS_EQUAL
5
 目前的值必須小於或等於指定的值。
 

如果 dwTypeBitMask 是VER_SUITENAME，此參數可以是下列其中一個值。

值 意義
VER_AND
6
 wSuiteMask 成員中指定的所有產品套件都必須存在於目前的系統中。
VER_OR
7
 目前系統中必須至少有一個指定的產品套件存在。

傳回值

函式會傳回條件遮罩值。

備註

針對 VerifyVersionInfo 函式之 dwTypeMask 參數中的每個位，呼叫此函式一次。

範例

如需範例，請參閱 驗證系統版本。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winnt.h (包括 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

OSVERSIONINFOEX

操作系統版本

系統資訊函式

VerifyVersionInfo