Compartilhar via


Função CM_Connect_MachineA (cfgmgr32.h)

[A partir do Windows 8 e do Windows Server 2012, a funcionalidade para acessar computadores remotos foi removida. Não é possível acessar computadores remotos durante a execução nessas versões do Windows.]

A função CM_Connect_Machine cria uma conexão com um computador remoto.

Sintaxe

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

Parâmetros

[in, optional] UNCServerName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres de texto que representa o nome UNC, incluindo o \ prefixo, do sistema para o qual uma conexão será feita. Se o ponteiro for NULL, o sistema local será usado.

[out] phMachine

Endereço de um local para receber um identificador de computador.

Nota Não há suporte para o uso dessa função para acessar computadores remotos a partir do Windows 8 e do Windows Server 2012, pois essa funcionalidade foi removida.
 

Valor retornado

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Os chamadores de CM_Connect_Machine devem chamar CM_Disconnect_Machine para desalocar o identificador do computador, depois que ele não for mais necessário.

Use identificadores de computador obtidos com essa função apenas com as funções do gerenciador de configurações PnP.

A funcionalidade para acessar computadores remotos foi removida nos sistemas operacionais Windows 8 e Windows Server 2012 e posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do Windows.

Requisitos

   
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib

Confira também

CM_Disconnect_Machine