funzione CM_Connect_MachineA (cfgmgr32.h)

[A partire da Windows 8 e funzionalità di Windows Server 2012 per accedere ai computer remoti è stata rimossa. Non è possibile accedere ai computer remoti durante l'esecuzione in queste versioni di Windows.]

La funzione CM_Connect_Machine crea una connessione a un computer remoto.

Sintassi

CMAPI CONFIGRET CM_Connect_MachineA(
  [in, optional] PCSTR     UNCServerName,
  [out]          PHMACHINE phMachine
);

Parametri

[in, optional] UNCServerName

Puntatore fornito dal chiamante a una stringa di testo che rappresenta il nome UNC, incluso il \ prefisso, del sistema per cui verrà effettuata una connessione. Se il puntatore è NULL, viene usato il sistema locale.

[out] phMachine

Indirizzo di una posizione per ricevere un handle del computer.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Commenti

I chiamanti di CM_Connect_Machine devono chiamare CM_Disconnect_Machine per deallocare l'handle del computer, dopo che non è più necessario.

Usare i handle di computer ottenuti con questa funzione solo con le funzioni di gestione configurazione PnP.

La funzionalità per accedere ai computer remoti è stata rimossa in Windows 8 e Windows Server 2012 e versioni successive, pertanto non è possibile accedere ai computer remoti quando in esecuzione in queste versioni di Windows.

Requisiti

Vedi anche

CM_Disconnect_Machine