Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die IoWMIHandleToInstanceName Routine bestimmt den Instanznamen für die vom Treiber implementierte WMI-Klasseninstanz, die 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 Instanznamen zurück, der dem Treiber entspricht, der durch das Dateihandle dargestellt wird.
[out] InstanceName
Zeigen Sie auf die UNICODE_STRING Struktur, die von der Routine zum Zurückgeben des Instanznamens verwendet wird. Der Aufrufer gibt den zurückgegebenen Puffer innerhalb UNICODE_STRINGfrei.
Rückgabewert
Die Routine gibt einen NTSTATUS-Code zurück. Mögliche Rückgabewerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang war erfolgreich. Die Routine füllt die UNICODE_STRING Struktur aus, auf die der InstanceName Parameter mit dem Instanznamen verweist. |
|
Der Treiber implementiert keine Instanzen der WMI-Klasse, die durch DataBlockObject-angegeben 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 Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |