IoWMISetSingleInstance-Funktion (wdm.h)

Artikel
07.02.2025

Die IoWMISetSingleInstance Routine legt die Werte für Eigenschaften innerhalb der Datenblockinstanz fest, die mit der angegebenen WMI-Klasse und dem Namen der Instanz übereinstimmen.

Syntax

C++

NTSTATUS IoWMISetSingleInstance(
  [in] PVOID           DataBlockObject,
  [in] PUNICODE_STRING InstanceName,
  [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 WMIGUID_SET Zugriffsrecht geöffnet werden.

[in] InstanceName

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

[in] Version

Reserviert für die zukünftige Verwendung. Aufrufer müssen diesen Parameter auf Null festlegen.

[in] ValueBufferSize

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

[in] ValueBuffer

Zeigen Sie auf den Puffer, der die neuen Werte für die Eigenschaften innerhalb des Datenblocks enthält.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Vorgang war erfolgreich. Die Werte der Eigenschaften der WMI-Datenblockinstanz werden 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 Instanz der WMI-Klasse mit InstanceName-eigenschaft dem wert, der im parameter InstanceName angegeben ist.
STATUS_WMI_READ_ONLY	Alle Eigenschaften der WMI-Klasse sind schreibgeschützt.
STATUS_WMI_SET_FAILURE	Der Treiber, der die WMI-Datenblockinstanz implementiert, kann die Instanz nicht aktualisieren.

Bemerkungen

IoWMISetSingleInstance bestimmt, welche Treiber den angegebenen WMI-Klassen- und Instanznamen unterstützen können, und gibt eine IRP_MN_CHANGE_SINGLE_INSTANCE Anforderung an jeden solchen Treiber aus. Der Treiber, der die Datenblockinstanz mit übereinstimmenden InstanceName-Eigenschaft exportiert, aktualisiert seine Datenblockinstanz. Beachten Sie, dass ein Datenblock sowohl schreibgeschützte als auch Lese-/Schreibeigenschaften aufweisen kann. In diesem Fall werden nur die Lese-/Schreibeigenschaften aktualisiert und STATUS_SUCCESS zurückgegeben.

Treiber können auch die IoWMISetSingleItem- Routine verwenden, um eine einzelne Eigenschaft innerhalb der Klasseninstanz zu aktualisieren.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows XP und höheren Versionen des Windows-Betriebssystems.
Zielplattform-	Universal
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL