Partager via


IoWMIHandleToInstanceName, fonction (wdm.h)

La routine IoWMIHandleToInstanceName détermine le nom de l’instance de classe WMI implémentée par le pilote spécifié par un handle de fichier.

Syntaxe

NTSTATUS IoWMIHandleToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  HANDLE          FileHandle,
  [out] PUNICODE_STRING InstanceName
);

Paramètres

[in] DataBlockObject

Pointeur vers un objet de bloc de données WMI. L’appelant ouvre l’objet de bloc de données pour la classe WMI avec la routine IoWMIOpenBlock.

[in] FileHandle

Spécifie un handle de fichier. La routine retourne le nom de l’instance correspondant au pilote représenté par le handle de fichier.

[out] InstanceName

Pointeur vers la structure UNICODE_STRING utilisée par la routine pour retourner le nom de l’instance. L’appelant libère la mémoire tampon retournée dans UNICODE_STRING.

Valeur de retour

La routine retourne un code NTSTATUS. Les valeurs de retour possibles sont les suivantes :

Retourner le code Description
STATUS_SUCCESS
L’opération a réussi. La routine remplit la structure UNICODE_STRING pointée par le paramètre InstanceName avec le nom de l’instance.
STATUS_WMI_INSTANCE_NOT_FOUND
Le pilote n’implémente aucune instance de la classe WMI spécifiée par DataBlockObject.

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows XP et versions ultérieures du système d’exploitation Windows.
plateforme cible Universel
d’en-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock