CM_Get_Parent_Ex, fonction (cfgmgr32.h)

  • Article

[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée. Utilisez CM_Get_Parent à la place.]

La fonction CM_Get_Parent_Ex obtient un périphérique instance handle au nœud parent d’un nœud d’appareil (devnode) spécifié dans l’arborescence d’appareils d’un ordinateur local ou distant.

Syntaxe

CMAPI CONFIGRET CM_Get_Parent_Ex(
  [out]          PDEVINST pdnDevInst,
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Paramètres

[out] pdnDevInst

Pointeur fourni par l’appelant vers l’appareil instance gérer vers le nœud parent que cette fonction récupère. Le handle récupéré est lié au handle de machine spécifié par hMachine.

[in] dnDevInst

Périphérique fourni par l’appelant instance handle lié au handle de machine spécifié par hMachine.

[in] ulFlags

Non utilisé, doit être égal à zéro.

[in, optional] hMachine

Handle de machine fourni par l’appelant auquel le handle de instance d’appareil fourni par l’appelant est lié.

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, la fonction retourne CR_SUCCESS. Sinon, elle 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
DLL Cfgmgr32.dll

Voir aussi

CM_Get_Child_Ex

CM_Get_Parent