funzione CM_Connect_MachineA (cfgmgr32.h)

  • Articolo

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

Nota L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.
 

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

   
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione cfgmgr32.h (include Cfgmgr32.h)
Libreria Cfgmgr32.lib

Vedi anche

CM_Disconnect_Machine