IoWMIQueryAllData-Funktion (wdm.h)
Die IoWMIQueryAllData-Routine gibt alle WMI-Datenblöcke zurück, die eine bestimmte WMI-Klasse implementieren.
Syntax
NTSTATUS IoWMIQueryAllData(
[in] PVOID DataBlockObject,
[in, out] PULONG InOutBufferSize,
[out, optional] PVOID OutBuffer
);
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 Zugriffsrecht WMIGUID_QUERY geöffnet werden.
[in, out] InOutBufferSize
Zeiger auf einen Speicherort, der die Größe des Puffers angibt, der im OutBuffer-Parameter übergeben wird. Wenn die Routine erfolgreich ist, wird der Speicherort des Arbeitsspeichers aktualisiert, um die Anzahl der tatsächlich in OutBuffer gespeicherten Bytes anzugeben. Wenn die Routine mit status Code von STATUS_BUFFER_TOO_SMALL fehlschlägt, gibt sie die Anzahl der Bytes zurück, die zum Zurückgeben der Daten erforderlich sind.
[out, optional] OutBuffer
Zeiger auf den Puffer, in dem die Routine die WMI-Daten zurückgibt. Die Routine gibt eine Sequenz von WNODE_ALL_DATA Strukturen variabler Größe zurück, eine für jeden Satz zurückgegebener Datenblöcke. Der WnodeHeader.Linkage-Member jeder WNODE_ALL_DATA-Struktur enthält den Offset vom Anfang der aktuellen WNODE_ALL_DATA bis zum Anfang der nächsten WNODE_ALL_DATA. Für den letzten Block in der Kette ist WnodeHeader.Linkage auf 0 (null) festgelegt. OutBuffer muss auf einen Puffer verweisen, der aus einem nicht auslagerten Pool zugeordnet ist.
Rückgabewert
Die Routine gibt einen NTSTATUS-Code zurück. Mögliche Rückgabewerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. Die Routine gibt die WMI-Daten im Puffer zurück, auf den der OutBuffer-Parameter verweist. Die Routine gibt auch die Größe der zurückgegebenen Daten in Bytes am Speicherort zurück, auf den der InOutBufferSize-Parameter verweist. |
|
Keine Treiber implementieren die angegebene WMI-Klasse. |
|
Der vom Aufrufer im OutBuffer-Parameter übergebene Puffer ist zu klein. Die Routine gibt die erforderliche Puffergröße am Speicherort zurück, auf den der InOutBufferSize-Parameter verweist. |
Hinweise
IoWMIQueryAllData bestimmt, welche Treiber die angegebene WMI-Klasse unterstützen, und gibt eine IRP_MN_QUERY_ALL_DATA-Anforderung an jeden solchen Treiber aus.
Verwenden Sie IoWMIQueryAllDataMultiple, um mehrere WMI-Klassen abzufragen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |