Fungsi IoWMIOpenBlock (wdm.h)

Artikel
02/29/2024

Rutinitas IoWMIOpenBlock membuka objek blok data WMI untuk kelas WMI yang ditentukan.

Sintaks

NTSTATUS IoWMIOpenBlock(
  [in]  LPCGUID Guid,
  [in]  ULONG   DesiredAccess,
  [out] PVOID   *DataBlockObject
);

Parameter

[in] Guid

Menentukan GUID untuk kelas WMI.

[in] DesiredAccess

Menentukan hak akses yang diinginkan ke objek blok data. Pemanggil harus memiliki hak akses tertentu untuk melakukan operasi tertentu.

Berikut ini adalah deskripsi dari setiap bit akses yang tepat dan operasi yang diizinkannya:

WMIGUID_EXECUTE

Objek blok data dapat digunakan untuk menjalankan metode kelas WMI. Bendera ini harus diatur untuk menggunakan IoWMIExecuteMethod pada objek blok data.

WMIGUID_NOTIFICATION

Objek blok data dapat digunakan untuk mendaftarkan panggilan balik pemberitahuan peristiwa. Bendera ini harus diatur untuk menggunakan IoWMISetNotificationCallback, dan hanya dapat digunakan untuk blok peristiwa WMI. Penelepon yang menentukan bendera ini juga harus menentukan bendera SYNCHRONIZE.

WMIGUID_QUERY

Objek blok data dapat digunakan untuk mengkueri properti kelas WMI. Bendera ini harus diatur untuk menggunakan salah satu rutinitas IoWMIQueryXxx pada objek blok data.

WMIGUID_SET

Objek blok data dapat digunakan untuk mengatur properti kelas WMI. Bendera ini harus diatur untuk menggunakan salah satu rutinitas IoWMISetXxx pada objek blok data.

[out] DataBlockObject

Penunjuk ke lokasi memori di mana rutinitas mengembalikan penunjuk ke objek blok data.

Nilai kembali

Mengembalikan STATUS_SUCCESS pada keberhasilan, atau kode kesalahan NTSTATUS yang sesuai pada kegagalan.

Keterangan

Pemanggil menggunakan IoWMIOpenBlock untuk membuat objek blok data untuk GUID kelas WMI yang ditentukan. Selanjutnya, pemanggil dapat menggunakan objek blok data untuk membaca atau menulis properti kelas WMI, menjalankan metode kelas WMI, dan mendaftarkan panggilan balik untuk peristiwa WMI.

Gunakan rutinitas IoWMIQueryXxx dan IoWMISetXxx untuk membaca dan menulis properti kelas WMI. Gunakan IoWMIExecuteMethod untuk menjalankan metode kelas WMI, dan gunakan IoWMISetNotificationCallback untuk mendaftarkan panggilan balik pemberitahuan peristiwa WMI.

Gunakan ObDereferenceObject untuk menutup objek blok data setelah tidak lagi diperlukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows XP dan versi sistem operasi Windows yang lebih baru.
Target Platform	Universal
Header	wdm.h (termasuk Ntddk.h, Ntifs.h. Nilai WMIGUID_XXX dideklarasikan dalam Wmistr.h. Untuk menggunakannya, sertakan Wmistr.h.)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL