CM_Locate_DevNode_ExA, fonction (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 périphérique instance handle sur le 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_ExA(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_A pDeviceID,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Paramètres
[out] pdnDevInst
[in, optional] pDeviceID
[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 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 de machine auquel un jeu d’informations d’appareil est lié. Le handle de machine d’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 sur 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.
La fonctionnalité permettant d’accéder aux ordinateurs distants a été supprimée dans Windows 8 et Windows Server 2012 systèmes d’exploitation et versions ultérieures. Vous ne pouvez donc pas accéder aux ordinateurs distants lors de l’exécution sur ces versions de Windows.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |