Fungsi VerSetConditionMask (winnt.h)

Artikel
03/13/2024

Mengatur bit nilai 64-bit untuk menunjukkan operator perbandingan yang akan digunakan untuk atribut versi sistem operasi tertentu. Fungsi ini digunakan untuk membangun parameter dwlConditionMask dari fungsi VerifyVersionInfo .

Sintaks

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

Parameter

[in] ConditionMask

Nilai yang akan diteruskan sebagai parameter dwlConditionMask dari fungsi VerifyVersionInfo . Fungsi menyimpan informasi perbandingan dalam bit variabel ini.

Sebelum panggilan pertama ke VerSetCondition, inisialisasi variabel ini ke nol. Untuk panggilan berikutnya, teruskan variabel yang digunakan dalam panggilan sebelumnya.

[in] TypeMask

Masker yang menunjukkan anggota struktur OSVERSIONINFOEX yang operator perbandingannya sedang diatur. Nilai ini sesuai dengan salah satu bit yang ditentukan dalam parameter dwTypeMask untuk fungsi VerifyVersionInfo . Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
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

Operator yang akan digunakan untuk perbandingan. Fungsi VerifyVersionInfo menggunakan operator ini untuk membandingkan nilai atribut tertentu dengan nilai yang sesuai untuk sistem yang sedang berjalan.

Untuk semua nilai dwTypeBitMask selain VER_SUITENAME, parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
VER_EQUAL 1	Nilai saat ini harus sama dengan nilai yang ditentukan.
VER_GREATER 2	Nilai saat ini harus lebih besar dari nilai yang ditentukan.
VER_GREATER_EQUAL 3	Nilai saat ini harus lebih besar dari atau sama dengan nilai yang ditentukan.
VER_LESS 4	Nilai saat ini harus kurang dari nilai yang ditentukan.
VER_LESS_EQUAL 5	Nilai saat ini harus kurang dari atau sama dengan nilai yang ditentukan.

Jika dwTypeBitMask VER_SUITENAME, parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
VER_AND 6	Semua suite produk yang ditentukan dalam anggota wSuiteMask harus ada dalam sistem saat ini.
VER_OR 7	Setidaknya salah satu suite produk yang ditentukan harus ada dalam sistem saat ini.

Mengembalikan nilai

Fungsi mengembalikan nilai masker kondisi.

Keterangan

Panggil fungsi ini sekali untuk setiap bit yang diatur dalam parameter dwTypeMask dari fungsi VerifyVersionInfo .

Contoh

Misalnya, lihat Memverifikasi Versi Sistem.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winnt.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

OSVERSIONINFOEX

Versi Sistem Operasi

Fungsi Informasi Sistem

VerifyVersionInfo

Bagikan melalui