fonction CM_Locate_DevNode_ExW (cfgmgr32.h)

  • Article

[À 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.

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.

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

Voir aussi

CM_Get_Child_Ex

CM_Locate_DevNode