Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die IoWMISetSingleItem- Routine legt eine einzelne Eigenschaft in der Datenblockinstanz fest, die dem angegebenen WMI-Klassen- und Instanznamen 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 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] DataItemId
Gibt die Datenelement-ID für die festzulegende Eigenschaft an. Der Wert dieses Parameters entspricht dem in der WmiDataId Qualifizierer für die Eigenschaft deklarierten Wert.
[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 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 |
|---|---|
|
Der Vorgang war erfolgreich. Der Wert der Eigenschaft in der WMI-Datenblockinstanz wird auf den Inhalt des Puffers aktualisiert, auf den der ValueBuffer-Parameter verweist. |
|
Keine Treiber implementieren die WMI-Klasse. |
|
Kein Treiber implementiert eine Instanz des WMI-Datenblocks mit InstanceName-Eigenschaft, die dem im parameter InstanceName angegebenen Wert entspricht. |
|
Die WMI-Klasse enthält keine Eigenschaft mit Datenelement-ID, die dem Wert von DataItemId-entspricht. |
|
Die Datenelement-ID im Datenblock ist schreibgeschützt. |
|
Der Treiber, der die WMI-Datenblockinstanz implementiert, kann die durch DataItemIdangegebene Eigenschaft nicht aktualisieren. |
Bemerkungen
IoWMISetSingleItem- bestimmt, welche Treiber den angegebenen WMI-Klassen- und Instanznamen unterstützen können. Es gibt eine IRP_MN_CHANGE_SINGLE_ITEM Anforderung an jeden solchen Treiber aus. Der Treiber, der die Datenblockinstanz mit übereinstimmenden InstanceName-Eigenschaft exportiert, aktualisiert die angegebene Eigenschaft in der Datenblockinstanz.
Treiber können auch IoWMISetSingleInstance- verwenden, um jede Eigenschaft der WMI-Klasseninstanz gleichzeitig 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 |