共用方式為

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程式代碼。 可能的傳回值包括：

傳回碼 描述
STATUS_SUCCESS
 作業成功。 例程會傳回 OutBuffer 參數所指向之緩衝區中的 WMI 數據。 例程也會傳回 InOutBufferSize 參數所指向之內存位置中傳回數據的大小，以位元組為單位。
STATUS_WMI_GUID_NOT_FOUND
 沒有驅動程式會實作指定的 WMI 類別。
STATUS_WMI_INSTANCE_NOT_FOUND
 沒有驅動程式會實作 WMI 類別的實例，InstanceName 屬性等於 InstanceName 參數中指定的值。
STATUS_BUFFER_TOO_SMALL
 OutBuffer 參數中呼叫端傳遞的緩衝區太小。 例程會傳回 InOutBufferSize 參數所指向之內存位置中所需的緩衝區大小。

言論

IoWMIQuerySingleInstance 會決定哪些驅動程式可能支援具有指定實例名稱的指定 WMI 類別，併發出每個這類驅動程式的 IRP_MN_QUERY_SINGLE_INSTANCE 要求。 匯出具有相符 InstanceName 屬性之數據區塊實例的驅動程式會傳回適當的數據。

若要查詢多個 WMI 類別和實例名稱，請使用 IoWMIQuerySingleInstanceMultiple 例程。 驅動程式可以使用 IoWMISetSingleInstance 例程來更新類別實例。

要求

要求 價值
最低支援的用戶端 適用於 Windows XP 和更新版本的 Windows作系統。
目標平臺 普遍
標頭 wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h）
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

IRP_MN_QUERY_SINGLE_INSTANCE

IoWMIOpenBlock

IoWMIQuerySingleInstanceMultiple

IoWMISetSingleInstance