Fungsi IoWMISuggestInstanceName (wdm.h)

  • Artikel

Rutinitas IoWMISuggestInstanceName digunakan untuk meminta agar WMI menyarankan nama dasar yang dapat digunakan driver untuk membangun nama instans WMI untuk perangkat.

Sintaks

NTSTATUS IoWMISuggestInstanceName(
  [in, optional] PDEVICE_OBJECT  PhysicalDeviceObject,
  [in, optional] PUNICODE_STRING SymbolicLinkName,
  [in]           BOOLEAN         CombineNames,
  [out]          PUNICODE_STRING SuggestedInstanceName
);

Parameter

[in, optional] PhysicalDeviceObject

Jika disediakan, menunjuk ke objek perangkat fisik driver.

[in, optional] SymbolicLinkName

Jika disediakan, arahkan ke nama tautan simbolis yang dikembalikan dari IoRegisterDeviceInterface.

[in] CombineNames

Jika TRUE , maka nama yang disarankan yang dikembalikan akan menggabungkan informasi PhysicalDeviceObject dan SymbolicLinkName .

[out] SuggestedInstanceName

Pointer ke buffer yang setelah berhasil diselesaikan akan berisi UNICODE_STRING yang berisi nama instans yang disarankan. Pemanggil bertanggung jawab untuk membebaskan buffer ini ketika tidak lagi diperlukan.

Nilai kembali

IoWMISuggestInstanceName mengembalikan kode status dari daftar berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Menunjukkan bahwa WMI berhasil menyelesaikan fungsi ini.
STATUS_UNSUCCESSFUL
 Menunjukkan bahwa layanan WMI tidak tersedia.
STATUS_INSUFFICIENT_RESOURCES
 Menunjukkan bahwa sumber daya yang tersedia tidak mencukupi untuk menyediakan buffer kepada pemanggil yang berisi string Unicode.
STATUS_NO_MEMORY
 Menunjukkan bahwa sumber daya yang tersedia tidak mencukupi untuk menyediakan buffer kepada pemanggil yang berisi string Unicode.

Keterangan

Jika parameter CombineNamesTRUE , maka PhysicalDeviceObject dan SymbolicLinkName harus ditentukan. Jika tidak, hanya satu dari mereka yang harus ditentukan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Lihat juga

IoWMIAllocateInstanceIds