Partager via


CM_Connect_MachineW, fonction (cfgmgr32.h)

[À compter de Windows 8 et Windows Server 2012 fonctionnalité permettant d’accéder aux machines distantes a été supprimée. Vous ne pouvez pas accéder aux ordinateurs distants lors de l’exécution sur ces versions de Windows.]

La fonction CM_Connect_Machine crée une connexion à un ordinateur distant.

Syntaxe

CMAPI CONFIGRET CM_Connect_MachineW(
  [in, optional] PCWSTR    UNCServerName,
  [out]          PHMACHINE phMachine
);

Paramètres

[in, optional] UNCServerName

Pointeur fourni par l’appelant vers une chaîne de texte représentant le nom UNC, y compris le \ préfixe, du système pour lequel une connexion sera établie. Si le pointeur a la valeur NULL, le système local est utilisé.

[out] phMachine

Adresse d’un emplacement pour recevoir un handle de machine.

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

Les appelants de CM_Connect_Machine doivent appeler CM_Disconnect_Machine pour libérer le handle de machine, une fois qu’il n’est plus nécessaire.

Utilisez les handles de machine obtenus avec cette fonction uniquement avec les fonctions de gestionnaire de configuration PnP.

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_Disconnect_Machine