IoWMIOpenBlock-Funktion (wdm.h)

Artikel
02/27/2024

Die IoWMIOpenBlock-Routine öffnet das WMI-Datenblockobjekt für die angegebene WMI-Klasse.

Syntax

NTSTATUS IoWMIOpenBlock(
  [in]  LPCGUID Guid,
  [in]  ULONG   DesiredAccess,
  [out] PVOID   *DataBlockObject
);

Parameter

[in] Guid

Gibt die GUID für die WMI-Klasse an.

[in] DesiredAccess

Gibt die gewünschten Zugriffsrechte für das Datenblockobjekt an. Der Aufrufer muss über bestimmte Zugriffsrechte verfügen, um bestimmte Vorgänge ausführen zu können.

Im Folgenden finden Sie eine Beschreibung der einzelnen Zugriffsbits und der damit zulässigen Vorgänge:

WMIGUID_EXECUTE

Das Datenblockobjekt kann zum Ausführen von WMI-Klassenmethoden verwendet werden. Dieses Flag muss für die Verwendung von IoWMIExecuteMethod für das Datenblockobjekt festgelegt werden.

WMIGUID_NOTIFICATION

Das Datenblockobjekt kann verwendet werden, um Ereignisbenachrichtigungsrückrufe zu registrieren. Dieses Flag muss für die Verwendung von IoWMISetNotificationCallback festgelegt werden und kann nur für WMI-Ereignisblöcke verwendet werden. Aufrufer, die dieses Flag angeben, müssen auch das SYNCHRONIZE-Flag angeben.

WMIGUID_QUERY

Das Datenblockobjekt kann verwendet werden, um WMI-Klasseneigenschaften abzufragen. Dieses Flag muss festgelegt werden, um eine der IoWMIQueryXxx-Routinen für das Datenblockobjekt zu verwenden.

WMIGUID_SET

Das Datenblockobjekt kann verwendet werden, um WMI-Klasseneigenschaften festzulegen. Dieses Flag muss festgelegt werden, um eine der Xxx-Routinen von IoWMISet für das Datenblockobjekt zu verwenden.

[out] DataBlockObject

Zeiger auf einen Speicherort, an dem die Routine einen Zeiger auf das Datenblockobjekt zurückgibt.

Rückgabewert

Gibt STATUS_SUCCESS bei Erfolg oder den entsprechenden NTSTATUS-Fehlercode bei Einem Fehler zurück.

Hinweise

Der Aufrufer verwendet IoWMIOpenBlock , um ein Datenblockobjekt für die angegebene GUID der WMI-Klasse zu erstellen. Anschließend kann der Aufrufer das Datenblockobjekt verwenden, um WMI-Klasseneigenschaften zu lesen oder zu schreiben, WMI-Klassenmethoden auszuführen und Rückrufe für WMI-Ereignisse zu registrieren.

Verwenden Sie die Xxx-Routinen IoWMIQuery und IoWMISet, um WMI-Klasseneigenschaften zu lesen und zu schreiben. Verwenden Sie IoWMIExecuteMethod , um WMI-Klassenmethoden auszuführen, und verwenden Sie IoWMISetNotificationCallback , um einen WMI-Ereignisbenachrichtigungsrückruf zu registrieren.

Verwenden Sie ObDereferenceObject , um das Datenblockobjekt zu schließen, sobald es nicht mehr benötigt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows XP und höheren Versionen des Windows-Betriebssystems.
Zielplattform	Universell
Header	wdm.h (include Ntddk.h, Ntifs.h. Die WMIGUID_XXX Werte werden in Wmistr.h deklariert. Um sie zu verwenden, schließen Sie Wmistr.h.) ein.
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL