Partager via


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.

Note L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à partir de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.
 

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

Voir aussi

CM_Get_Child_Ex
CM_Locate_DevNode