Compartilhar via


Função NetServerTransportAdd (lmserver.h)

A função NetServerTransportAdd associa o servidor ao protocolo de transporte.

A função estendida NetServerTransportAddEx permite que o aplicativo de chamada especifique os níveis de informações SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 e SERVER_TRANSPORT_INFO_3 .

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetServerTransportAdd(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

Parâmetros

[in] servername

Um 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] level

Especifica o nível de informações dos dados. Esse parâmetro pode ser o valor a seguir.

Valor Significado
0
Especifica informações sobre o protocolo de transporte, incluindo nome, endereço e local na rede. O parâmetro bufptr aponta para uma estrutura SERVER_TRANSPORT_INFO_0 .

[in] bufptr

Um ponteiro para o buffer que contém os dados.

Para obter mais informações, consulte Buffers de função de gerenciamento de rede.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NERR_Success.

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_LEVEL
O valor especificado para o parâmetro level é inválido.
ERROR_INVALID_PARAMETER
Um parâmetro é inválido.

Esse erro será retornado se o membro svti0_transportname ou svti0_transportaddress na estrutura SERVER_TRANSPORT_INFO_0 apontada pelo parâmetro bufptr for NULL. Esse erro também será retornado se o membro svti0_transportaddresslength na estrutura SERVER_TRANSPORT_INFO_0 apontada pelo parâmetro bufptr for zero ou maior que MAX_PATH (definido no arquivo de cabeçalho Windef.h).

Esse erro também é retornado para outros parâmetros inválidos.

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

Se você adicionar um protocolo de transporte a um servidor usando uma chamada para a função NetServerTransportAdd , a conexão não permanecerá após a reinicialização ou reinicialização do servidor.

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

NetServerComputerNameAdd

NetServerComputerNameDel

NetServerTransportAddEx

NetServerTransportDel

NetServerTransportEnum

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

SERVER_TRANSPORT_INFO_2

SERVER_TRANSPORT_INFO_3

Funções de transporte de servidor e estação de trabalho