IoWMIHandleToInstanceName 函式 (wdm.h)
IoWMIHandleToInstanceName 例程會決定檔案句柄所指定驅動程式所實作之 WMI 類別實例的實例名稱。
NTSTATUS IoWMIHandleToInstanceName(
[in] PVOID DataBlockObject,
[in] HANDLE FileHandle,
[out] PUNICODE_STRING InstanceName
);
[in] DataBlockObject
WMI 數據區塊物件的指標。 呼叫端會使用 ioWMIOpenBlock 例程,開啟 WMI 類別的數據區塊物件。
[in] FileHandle
指定檔句柄。 例程會傳回對應至檔案句柄所表示之驅動程序的實例名稱。
[out] InstanceName
例程用來傳回實例名稱之 UNICODE_STRING 結構的指標。 呼叫端會在 UNICODE_STRING內釋放傳回的緩衝區。
例程會傳回NTSTATUS程式代碼。 可能的傳回值包括:
傳回碼 | 描述 |
---|---|
|
作業成功。 例程會填入實例名稱 InstanceName 參數所指向的 UNICODE_STRING 結構。 |
|
驅動程式不會實作由 DataBlockObject所指定的 WMI 類別實例。 |
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows XP 和更新版本的 Windows作系統。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |