Função NetServerTransportAdd (lmserver.h)

Artigo
02/28/2024

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