IoWMISetSingleItem-Funktion (wdm.h)

Artikel
08/08/2023

Die IoWMISetSingleItem-Routine legt eine einzelne Eigenschaft im Datenblock instance fest, die der angegebenen WMI-Klasse und instance Namen entspricht.

Syntax

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

Parameter

[in] DataBlockObject

Zeiger auf ein WMI-Datenblockobjekt. Der Aufrufer öffnet das Datenblockobjekt für die WMI-Klasse mit der IoWMIOpenBlock-Routine . Das Objekt muss mit dem zugriffsrecht WMIGUID_SET geöffnet werden.

[in] InstanceName

Gibt den Namen des instance des Datenblocks an. Dieser Wert entspricht dem Wert der InstanceName-Eigenschaft für den Block.

[in] DataItemId

Gibt die Datenelement-ID für die festzulegende Eigenschaft an. Der Wert dieses Parameters entspricht dem Wert, der im WmiDataId-Qualifizierer für die -Eigenschaft deklariert ist.

[in] Version

Für die zukünftige Verwendung reserviert. Aufrufer müssen diesen Parameter auf 0 (null) festlegen.

[in] ValueBufferSize

Gibt die Größe des Puffers in Bytes an, der im ValueBuffer-Parameter übergeben wird.

[in] ValueBuffer

Zeiger auf den Puffer, der den neuen Wert für die durch den DataItemId-Parameter angegebene Eigenschaft enthält.

Rückgabewert

Die Routine gibt einen NTSTATUS-Code zurück. Mögliche Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Vorgang wurde erfolgreich ausgeführt. Der Wert der -Eigenschaft innerhalb des WMI-Datenblocks instance wird auf den Inhalt des Puffers aktualisiert, auf den der ValueBuffer-Parameter verweist.
STATUS_WMI_GUID_NOT_FOUND	Keine Treiber implementieren die WMI-Klasse.
STATUS_WMI_INSTANCE_NOT_FOUND	Kein Treiber implementiert eine instance des WMI-Datenblocks mit der InstanceName-Eigenschaft, die dem im InstanceName-Parameter angegebenen Wert entspricht.
STATUS_WMI_ITEMID_NOT_FOUND	Die WMI-Klasse enthält keine Eigenschaft, deren Datenelement-ID dem Wert von DataItemId entspricht.
STATUS_WMI_READ_ONLY	Die Datenelement-ID im Datenblock ist schreibgeschützt.
STATUS_WMI_SET_FAILURE	Der Treiber, der den WMI-Datenblock implementiert, instance kann die durch DataItemId angegebene Eigenschaft nicht aktualisieren.

Hinweise

IoWMISetSingleItem bestimmt, welche Treiber die angegebene WMI-Klasse und instance Namen unterstützen. An jeden dieser Treiber wird eine IRP_MN_CHANGE_SINGLE_ITEM-Anforderung gestellt. Der Treiber, der den Datenblock instance mit der übereinstimmenden InstanceName-Eigenschaft exportiert, aktualisiert die angegebene Eigenschaft im Datenblock instance.

Treiber können auch IoWMISetSingleInstance verwenden, um jede Eigenschaft der WMI-Klasse instance gleichzeitig zu aktualisieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows XP und höheren Versionen des Windows-Betriebssystems.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Weitere Informationen

IRP_MN_CHANGE_SINGLE_ITEM

IoWMIOpenBlock

IoWMIQuerySingleInstance

IoWMISetSingleInstance

Freigeben über