Função NetServerComputerNameAdd (lmserver.h)

Artigo
03/05/2024

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