Fungsi IoWMIHandleToInstanceName (wdm.h)

  • Artikel

Rutinitas IoWMIHandleToInstanceName menentukan nama instans untuk instans kelas WMI yang diterapkan oleh driver yang ditentukan oleh handel file.

Sintaks

NTSTATUS IoWMIHandleToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  HANDLE          FileHandle,
  [out] PUNICODE_STRING InstanceName
);

Parameter

[in] DataBlockObject

Penunjuk ke objek blok data WMI. Pemanggil membuka objek blok data untuk kelas WMI dengan rutinitas IoWMIOpenBlock .

[in] FileHandle

Menentukan handel file. Rutinitas mengembalikan nama instans yang sesuai dengan driver yang diwakili oleh handel file.

[out] InstanceName

Arahkan ke struktur UNICODE_STRING yang digunakan rutinitas untuk mengembalikan nama instans. Penelepon membebaskan buffer yang dikembalikan dalam UNICODE_STRING.

Nilai kembali

Rutinitas mengembalikan kode NTSTATUS. Kemungkinan nilai yang dikembalikan meliputi:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Operasi berhasil. Rutinitas mengisi struktur UNICODE_STRING yang ditujukkan oleh parameter InstanceName dengan nama instans.
STATUS_WMI_INSTANCE_NOT_FOUND
 Driver tidak mengimplementasikan instans apa pun dari kelas WMI yang ditentukan oleh DataBlockObject.

Persyaratan

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

Lihat juga

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock