ioWMIQuerySingleInstance 函式 (wdm.h)
IoWMIQuerySingleInstance 例程會傳回指定的 WMI 數據區塊實例。
語法
NTSTATUS IoWMIQuerySingleInstance(
[in] PVOID DataBlockObject,
[in] PUNICODE_STRING InstanceName,
[in, out] PULONG InOutBufferSize,
[out, optional] PVOID OutBuffer
);
參數
[in] DataBlockObject
WMI 數據區塊物件的指標。 呼叫端會使用 IoWMIOpenBlock 例程開啟WMI類別的數據區塊物件。 對象必須以WMIGUID_QUERY訪問許可權開啟。
[in] InstanceName
指定數據區塊實例的名稱。 這個值會對應至 區塊的 InstanceName 屬性值。
[in, out] InOutBufferSize
記憶體位置的指標，指定 在 OutBuffer 參數中傳遞的緩衝區大小。 如果例程成功，它會更新記憶體位置，以指定實際儲存在 OutBuffer 中的位元元組數目。 如果例程失敗，狀態代碼為 STATUS_BUFFER_TOO_SMALL，它會傳回傳回數據所需的位元組數目。
[out, optional] OutBuffer
例程傳回 WMI 數據的緩衝區指標。 例程會傳回可變大小的 WNODE_SINGLE_INSTANCE 結構。 OutBuffer 必須指向從非分頁集區配置的緩衝區。
傳回值
例程會傳回NTSTATUS程式代碼。 可能的傳回值包括：
| 傳回碼 | Description |
|---|---|
|
作業成功。 例程會傳回 OutBuffer 參數所指向之緩衝區中的 WMI 數據。 例程也會傳回 InOutBufferSize 參數所指向記憶體位置中傳回數據的大小，以位元組為單位。 |
|
沒有驅動程式會實作指定的 WMI 類別。 |
|
沒有驅動程式會實作 WMI 類別的實例， 其 InstanceName 屬性等於 InstanceName 參數中指定的值。 |
|
OutBuffer 參數中呼叫端傳遞的緩衝區太小。 例程會傳回 InOutBufferSize 參數所指向記憶體位置中所需的緩衝區大小。 |
備註
IoWMIQuerySingleInstance 會決定哪些驅動程式可能支援具有指定實例名稱的指定 WMI 類別，並發出每個這類驅動程式 的IRP_MN_QUERY_SINGLE_INSTANCE 要求。 匯出具有相符 InstanceName 屬性之數據區塊實例的驅動程式會傳回適當的數據。
若要查詢多個 WMI 類別和實例名稱，請使用 IoWMIQuerySingleInstanceMultiple 例程。 驅動程式可以使用 IoWMISetSingleInstance 例程來更新類別實例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows XP 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |