Partager via


CM_Locate_DevNodeA, 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_DevNodeA(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_A 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

   
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