fonction CM_Locate_DevNodeA (cfgmgr32.h)
La fonction CM_Locate_DevNode obtient un handle d’instance d’appareil sur le nœud d’appareil associé à un ID d’instance d’appareil spécifié sur l’ordinateur local.
Syntaxe
CMAPI CONFIGRET CM_Locate_DevNodeA(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_A pDeviceID,
[in] ULONG ulFlags
);
Paramètres
[out] pdnDevInst
Pointeur vers un handle d’instance d’appareil qui CM_Locate_DevNode récupère. Le handle récupéré est lié à l’ordinateur local.
[in, optional] pDeviceID
Pointeur vers une chaîne terminée par NULL représentant un ID d’instance d’appareil . Si cette valeur est NULL ou si elle pointe vers une chaîne de longueur nulle, la fonction récupère un handle d’instance d’appareil à la racine de l’arborescence de l’appareil .
[in] ulFlags
Variable de type ULONG qui fournit l’une des valeurs d’indicateur suivantes qui s’appliquent si l’appelant fournit un identificateur d’instance d’appareil :
CM_LOCATE_DEVNODE_NORMAL
La fonction récupère le handle d’instance de l’appareil pour l’appareil spécifié uniquement si l’appareil est actuellement configuré dans l’arborescence de l’appareil.
CM_LOCATE_DEVNODE_PHANTOM
La fonction récupère un handle d’instance d’appareil pour l’appareil spécifié si l’appareil est actuellement configuré dans l’arborescence de l’appareil ou si l’appareil est un appareil non présent qui n’est pas actuellement configuré dans l’arborescence de l’appareil.
CM_LOCATE_DEVNODE_CANCELREMOVE
La fonction récupère un handle d’instance d’appareil pour l’appareil spécifié si l’appareil est actuellement configuré dans l’arborescence de l’appareil ou dans le processus de suppression de l’arborescence de l’appareil. Si l’appareil est en cours de suppression, la fonction annule la suppression de l’appareil.
CM_LOCATE_DEVNODE_NOVALIDATION
Non utilisé.
Valeur de retour
Si l’opération réussit, CM_Locate_DevNode retourne CR_SUCCESS. Sinon, la fonction retourne l’un des codes d’erreur CR_Xxx définis dans Cfgmgr32.h.
Remarques
Pour plus d’informations sur l’utilisation de handles d’instance d’appareil liés à l’ordinateur local, consultez CM_Get_Child.
Note
L’en-tête cfgmgr32.h définit CM_Locate_DevNode en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’en-tête | cfgmgr32.h (include Cfgmgr32.h) |
| bibliothèque | Cfgmgr32.lib |
| DLL | CfgMgr32.dll |