fonction CM_Locate_DevNode_ExW (cfgmgr32.h)
[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée. Utilisez CM_Locate_DevNode à la place.]
La fonction CM_Locate_DevNode_Ex obtient un handle d’appareil instance au nœud d’appareil associé à un id de instance d’appareil spécifié, sur un ordinateur local ou un ordinateur distant.
Syntaxe
CMAPI CONFIGRET CM_Locate_DevNode_ExW(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_W pDeviceID,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Paramètres
[out] pdnDevInst
Pointeur vers l’appareil instance gérer que cette fonction récupère. Le handle récupéré est lié au handle de machine spécifié par hMachine.
[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 fournit un périphérique instance handle à 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 périphérique 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ésent 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 pour 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é.
[in, optional] hMachine
Un handle de machine obtenu à partir d’un appel à CM_Connect_Machine, ou un handle d’ordinateur auquel un jeu d’informations d’appareil est lié. Le handle de machine pour un jeu d’informations d’appareil est obtenu à partir du membre RemoteMachineHandle de la structure SP_DEVINFO_LIST_DETAIL_DATA pour le jeu d’informations de l’appareil. Appelez SetupDiGetDeviceInfoListDetail pour obtenir une structure SP_DEVINFO_LIST_DETAIL_DATA.
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 préfixés CR_ définis dans Cfgmgr32.h.
Remarques
Pour plus d’informations sur l’utilisation de handles de instance d’appareil liés à un ordinateur local ou distant, consultez CM_Get_Child_Ex.
Les fonctionnalités d’accès aux machines distantes ont été supprimées dans les systèmes d’exploitation Windows 8 et Windows Server 2012 et versions ultérieures. Vous ne pouvez donc pas accéder aux machines distantes lors de l’exécution sur ces versions de Windows.
Configuration requise
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | cfgmgr32.h (inclure Cfgmgr32.h) |
| Bibliothèque | Cfgmgr32.lib |