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
STATUS_SUCCESS	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.
STATUS_WMI_INSTANCE_NOT_FOUND	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

Weitere Informationen

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock