共用方式為

IoWMISetSingleInstance 函式 （wdm.h）

  • 發行項

IoWMISetSingleInstance 例程會設定數據區塊實例內符合指定 WMI 類別和實例名稱的屬性值。

語法

NTSTATUS IoWMISetSingleInstance(
  [in] PVOID           DataBlockObject,
  [in] PUNICODE_STRING InstanceName,
  [in] ULONG           Version,
  [in] ULONG           ValueBufferSize,
  [in] PVOID           ValueBuffer
);

參數

[in] DataBlockObject

WMI 數據區塊物件的指標。 呼叫端會使用 ioWMIOpenBlock 例程，開啟 WMI 類別的數據區塊物件。 對象必須以WMIGUID_SET訪問許可權開啟。

[in] InstanceName

指定數據區塊實例的名稱。 這個值對應於 區塊 InstanceName 屬性的值。

[in] Version

保留供日後使用。 呼叫端必須將此參數設定為零。

[in] ValueBufferSize

指定傳入 ValueBuffer 參數之緩衝區的大小，以位元組為單位。

[in] ValueBuffer

緩衝區的指標，其中包含數據區塊內屬性的新值。

傳回值

例程會傳回NTSTATUS程式代碼。 可能的傳回值包括：

傳回碼 描述
STATUS_SUCCESS
 作業成功。 WMI 數據區塊實例屬性的值會更新為 ValueBuffer 參數所指向的緩衝區內容。
STATUS_WMI_GUID_NOT_FOUND
 沒有驅動程式會實作 WMI 類別。
STATUS_WMI_INSTANCE_NOT_FOUND
 沒有驅動程式會實作 WMI 類別的實例，InstanceName 屬性等於 InstanceName 參數中指定的值。
STATUS_WMI_READ_ONLY
 WMI 類別的所有屬性都是唯讀的。
STATUS_WMI_SET_FAILURE
 實作 WMI 數據區塊實例的驅動程式無法更新實例。

言論

IoWMISetSingleInstance 會決定哪些驅動程式可能支援指定的 WMI 類別和實例名稱，並發出每個這類驅動程式的 IRP_MN_CHANGE_SINGLE_INSTANCE 要求。 匯出具有相符 InstanceName 屬性之數據區塊實例的驅動程式會更新其數據區塊實例。 請注意，數據區塊可能同時具有唯讀和讀取/寫入屬性。 在此情況下，只會更新讀取/寫入屬性，並傳回STATUS_SUCCESS。

驅動程式也可以使用 IoWMISetSingleItem 例程來更新類別實例內的單一屬性。

要求

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

另請參閱

IRP_MN_CHANGE_SINGLE_INSTANCE

IoWMIOpenBlock

IoWMIQuerySingleInstance

IoWMISetSingleItem