funzione CM_Connect_MachineW (cfgmgr32.h)

  • Articolo

[A partire da Windows 8 e Windows Server 2012 funzionalità 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_MachineW(
  [in, optional] PCWSTR    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à stabilita una connessione. Se il puntatore è NULL, viene usato il sistema locale.

[out] phMachine

Indirizzo di un percorso 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 handle di computer ottenuti con questa funzione solo con le funzioni di gestione della configurazione PnP.

Le funzionalità per accedere ai computer remoti sono state rimosse in Windows 8 e Windows Server 2012 e sistemi operativi successivi, pertanto non è possibile accedere ai computer remoti durante l'esecuzione in queste versioni di Windows.

Requisiti

Requisito Valore
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