IoWMIOpenBlock-Funktion (wdm.h)
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 |