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 auszuführen.
Im Folgenden finden Sie eine Beschreibung der einzelnen zugriffsrechten Bits und der darin zulässigen Vorgänge:
WMIGUID_EXECUTE
Das Datenblockobjekt kann zum Ausführen von WMI-Klassenmethoden verwendet werden. Dieses Flag muss so festgelegt werden, dass IoWMIExecuteMethod- für das Datenblockobjekt verwendet wird.
WMIGUID_NOTIFICATION
Das Datenblockobjekt kann zum Registrieren von Ereignisbenachrichtigungsrückrufen verwendet werden. Dieses Flag muss so festgelegt werden, dass IoWMISetNotificationCallback-verwendet werden kann und nur für WMI-Ereignisblöcke verwendet werden kann. Aufrufer, die dieses Flag angeben, müssen auch das SYNCHRONIZE-Flag angeben.
WMIGUID_QUERY
Das Datenblockobjekt kann zum Abfragen von WMI-Klasseneigenschaften verwendet werden. Dieses Flag muss so festgelegt werden, dass eine der IoWMIQueryXxx Routinen für das Datenblockobjekt verwendet werden soll.
WMIGUID_SET
Das Datenblockobjekt kann zum Festlegen von WMI-Klasseneigenschaften verwendet werden. Dieses Flag muss so festgelegt werden, dass eine der IoWMISet-Xxx- Routinen für das Datenblockobjekt verwendet werden soll.
[out] DataBlockObject
Zeiger auf eine Speicherposition, an der 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.
Bemerkungen
Der Aufrufer verwendet IoWMIOpenBlock- zum Erstellen eines Datenblockobjekts für die angegebene WMI-Klassen-GUID. 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 IoWMIQueryXxx- und IoWMISet-Xxx--Routinen zum Lesen und Schreiben von WMI-Klasseneigenschaften. Verwenden Sie IoWMIExecuteMethod- zum Ausführen von WMI-Klassenmethoden, 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows XP und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform- | Universal |
| 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. |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |