Compartilhar via


Função NetServerComputerNameAdd (lmserver.h)

A função NetServerComputerNameAdd enumera os transportes nos quais o servidor especificado está ativo e associa o nome do servidor emulado a cada um dos transportes.

NetServerComputerNameAdd é uma função de utilitário que combina a funcionalidade da função NetServerTransportEnum e a função NetServerTransportAddEx .

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetServerComputerNameAdd(
  [in] LMSTR ServerName,
  [in] LMSTR EmulatedDomainName,
  [in] LMSTR EmulatedServerName
);

Parâmetros

[in] ServerName

Ponteiro para uma cadeia de caracteres que especifica o nome do servidor remoto no qual a função deve ser executada. Se esse parâmetro for NULL, o computador local será usado.

[in] EmulatedDomainName

Ponteiro para uma cadeia de caracteres que contém o nome de domínio que o servidor especificado deve usar ao anunciar sua presença usando o EmulatedServerName. Esse parâmetro é opcional.

[in] EmulatedServerName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome emulado que o servidor deve começar a dar suporte, além do nome especificado pelo parâmetro ServerName .

Retornar valor

Se a função for bem-sucedida, o valor retornado será NERR_Success. Observe que NetServerComputerNameAdd terá êxito se o nome do servidor emulado especificado for adicionado a pelo menos um transporte.

Se a função falhar, o valor retornado poderá ser um dos códigos de erro a seguir.

Código de retorno Descrição
ERROR_ACCESS_DENIED
O usuário não tem acesso às informações solicitadas.
ERROR_DUP_NAME
Existe um nome duplicado na rede.
ERROR_INVALID_DOMAINNAME
Não foi possível encontrar o nome de domínio na rede.
ERROR_INVALID_PARAMETER
O parâmetro especificado é inválido.
ERROR_NOT_ENOUGH_MEMORY
Memória insuficiente disponível.

Comentários

Somente membros do grupo local Administradores ou Operadores de Servidor podem executar com êxito a função NetServerComputerNameAdd .

O servidor especificado pelo parâmetro ServerName continua a dar suporte a todos os nomes com suporte e, além disso, começa a dar suporte a novos nomes fornecidos por chamadas bem-sucedidas para a função NetServerComputerNameAdd .

A emulação de nome resultante de uma chamada para NetServerComputerNameAdd termina quando o servidor reinicializa ou reinicia. Para descontinuar a emulação de nome definida por uma chamada anterior para NetServerComputerNameAdd sem reiniciar ou reinicializar, você pode chamar a função NetServerComputerNameDel .

A função NetServerComputerNameAdd normalmente é usada quando um administrador do sistema substitui um servidor, mas deseja manter a conversão transparente para os usuários.

Exemplos

Veja a seguir um exemplo de uma chamada para a função NetServerComputerNameAdd solicitando que \Server1 também responda a solicitações para \Server2.

NetServerComputerNameAdd (Server1, NULL, Server2);

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho lmserver.h (inclua Lm.h)
Biblioteca Netapi32.lib
DLL Netapi32.dll

Confira também

NetServerComputerNameDel

NetServerTransportAdd

NetServerTransportAddEx

NetServerTransportEnum

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede

Funções de servidor