CM_Locate_DevNodeW, fonction (cfgmgr32.h)

La fonction CM_Locate_DevNode obtient un handle d’appareil instance au nœud de l’appareil associé à un ID de instance d’appareil spécifié sur l’ordinateur local.

Syntaxe

CMAPI CONFIGRET CM_Locate_DevNodeW(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags
);

Paramètres

[out] pdnDevInst

Pointeur vers un handle de instance d’appareil que 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 de 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 appareil instance handle sur l’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 de instance d’appareil :

CM_LOCATE_DEVNODE_NORMAL

La fonction récupère l’appareil instance handle 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 appareil instance handle pour l’appareil spécifié si l’appareil est actuellement configuré dans l’arborescence de l’appareil ou s’il s’agit d’un appareil non prédéplis qui n’est pas actuellement configuré dans l’arborescence de l’appareil.

CM_LOCATE_DEVNODE_CANCELREMOVE

La fonction récupère un périphérique instance handle pour l’appareil spécifié si l’appareil est actuellement configuré dans l’arborescence de l’appareil ou en cours 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 retournée

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 de instance d’appareil liés à l’ordinateur local, consultez CM_Get_Child.

Notes

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib
DLL	CfgMgr32.dll

Voir aussi

CM_Get_Child

CM_Locate_DevNode_Ex