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