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