IoWMIHandleToInstanceName-Funktion (wdm.h)
Die IoWMIHandleToInstanceName-Routine bestimmt den instance Namen für die WMI-Klasse instance vom Treiber implementiert, der durch ein Dateihandle angegeben wird.
Syntax
NTSTATUS IoWMIHandleToInstanceName(
[in] PVOID DataBlockObject,
[in] HANDLE FileHandle,
[out] PUNICODE_STRING InstanceName
);
Parameter
[in] DataBlockObject
Zeiger auf ein WMI-Datenblockobjekt. Der Aufrufer öffnet das Datenblockobjekt für die WMI-Klasse mit der IoWMIOpenBlock-Routine .
[in] FileHandle
Gibt ein Dateihandle an. Die Routine gibt den instance Namen zurück, der dem Treiber entspricht, der durch das Dateihandle dargestellt wird.
[out] InstanceName
Zeiger auf die UNICODE_STRING-Struktur, die die Routine verwendet, um den namen der instance zurückzugeben. Der Aufrufer gibt den zurückgegebenen Puffer innerhalb UNICODE_STRING frei.
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 füllt die UNICODE_STRING Struktur, auf die der InstanceName-Parameter verweist, mit dem instance Namen aus. |
|
Der Treiber implementiert keine Instanzen der von DataBlockObject angegebenen WMI-Klasse. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in 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 |