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 |