IoWMIHandleToInstanceName-Funktion (wdm.h)

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
STATUS_SUCCESS	Der Vorgang war erfolgreich. Die Routine füllt die UNICODE_STRING Struktur aus, auf die der InstanceName Parameter mit dem Instanznamen verweist.
STATUS_WMI_INSTANCE_NOT_FOUND	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

Siehe auch

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock-