Fonction IoWMIHandleToInstanceName (wdm.h)

  • Article

La routine IoWMIHandleToInstanceName détermine le nom instance de la classe WMI instance 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 instance correspondant au pilote représenté par le handle de fichier.

[out] InstanceName

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

Valeur retournée

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

Code de retour 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 instance.
STATUS_WMI_INSTANCE_NOT_FOUND
 Le pilote n’implémente aucune instance de la classe WMI spécifiée par DataBlockObject.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows XP et versions ultérieures du système d’exploitation Windows.
Plateforme cible Universal
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