Função NetServerTransportAddEx (lmserver.h)

Artigo
03/14/2023

A função NetServerTransportAddEx associa o servidor especificado ao protocolo de transporte. Essa função estendida permite que o aplicativo de chamada especifique os níveis de informações SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 ou SERVER_TRANSPORT_INFO_3 .

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetServerTransportAddEx(
  [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 um valor que indica o nível de informações dos dados. Esse parâmetro pode usar um dos valores 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 de SERVER_TRANSPORT_INFO_0 .
1	Especifica informações sobre o protocolo de transporte, incluindo nome, endereço, local de rede e domínio. O parâmetro bufptr aponta para uma estrutura de SERVER_TRANSPORT_INFO_1 .
2	Especifica as mesmas informações que o nível 1, com a adição de um membro svti2_flags . O parâmetro bufptr aponta para uma estrutura de SERVER_TRANSPORT_INFO_2 .
3	Especifica as mesmas informações que o nível 2, com a adição de informações de credencial. O parâmetro bufptr aponta para uma estrutura SERVER_TRANSPORT_INFO_3 .

[in] bufptr

Um ponteiro para o buffer que contém os dados. O formato desses dados depende do valor do parâmetro de nível .

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

Valor retornado

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 seguintes códigos de erro.

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 de nível é inválido.
ERROR_INVALID_PARAMETER	Um parâmetro é inválido. Esse erro será retornado se o nome do transporte ou o membro do endereço de transporte no SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 ou SERVER_TRANSPORT_INFO_3 estrutura apontada pelo parâmetro bufptr for NULL. Esse erro também será retornado se o membro de comprimento do endereço de transporte no SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 ou SERVER_TRANSPORT_INFO_3 estrutura apontada pelo parâmetro bufptr for zero ou maior que MAX_PATH (definido no arquivo de cabeçalho Windef.h ). Esse erro também será retornado se o membro de sinalizadores do SERVER_TRANSPORT_INFO_2 ou SERVER_TRANSPORT_INFO_3 estrutura apontada pelo parâmetro bufptr contiver um valor inválido. Esse erro também é retornado para outros parâmetros inválidos.
ERROR_NOT_ENOUGH_MEMORY	Memória insuficiente disponível.

Comentários

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

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

A função NetServerComputerNameAdd é uma função de utilitário. Ele combina os recursos da função NetServerTransportEnum e da função NetServerTransportAddEx , permitindo que você especifique um nome de servidor emulado.

No Windows Server 2008 e no Windows Vista com Service Pack 1 (SP1), todos os nomes registrados com o SRV (servidor de arquivos remoto) do Windows são designados como um nome com escopo ou um nome sem escopo. Cada compartilhamento adicionado ao sistema será anexado a todos os nomes não com escopo ou a um único nome com escopo. Os aplicativos que desejam usar os recursos de escopo são responsáveis por registrar o novo nome como um ponto de extremidade com escopo e, em seguida, criar os compartilhamentos com um escopo apropriado. Dessa forma, os usos herdados das funções Gerenciamento de Rede e Gerenciamento de Compartilhamento de Rede não são afetados de forma alguma, pois continuam registrando compartilhamentos e nomes como nomes sem escopo.

Um ponto de extremidade com escopo é criado chamando a função NetServerTransportAddEx com o parâmetro de nível definido como 2 e o parâmetro bufptr apontado para uma estrutura SERVER_TRANSPORT_INFO_2 com o valor de bit SVTI2_SCOPED_NAME definido em svti2_flags membro. Um ponto de extremidade com escopo também é criado chamando a função NetServerTransportAddEx com o parâmetro de nível definido como 3 e o parâmetro bufptr apontado para uma estrutura SERVER_TRANSPORT_INFO_3 com o valor de bit SVTI2_SCOPED_NAME definido em svti3_flags membro.

Quando o valor de bit SVTI2_SCOPED_NAME é definido para um transporte, os compartilhamentos podem ser adicionados com um nome de servidor correspondente (o membro shi503_servername da estrutura SHARE_INFO_503 ) de forma com escopo usando a função NetShareAdd . Se não houver nenhum transporte registrado com o valor de bit SVTI2_SCOPED_NAME e o nome fornecido em shi503_servername membro, o compartilhamento adicionar de forma com escopo não terá êxito.

A função NetShareAdd é usada para adicionar um compartilhamento com escopo em um servidor remoto especificado no parâmetro servername . O servidor remoto especificado no shi503_servername membro do SHARE_INFO_503 passado no parâmetro bufptr deve ter sido associado a um protocolo de transporte usando a função NetServerTransportAddEx como um ponto de extremidade com escopo. O sinalizador SVTI2_SCOPED_NAME deve ter sido especificado no membro shi503_servername da estrutura SERVER_TRANSPORT_INFO_2 ou SERVER_TRANSPORT_INFO_3 do protocolo de transporte. A função NetShareDelEx é usada para excluir um compartilhamento com escopo. As funções NetShareGetInfo e NetShareSetInfo são usadas para obter e definir informações sobre um compartilhamento com escopo.

Os pontos de extremidade com escopo geralmente são usados pelo namespace do cluster.

Requisitos


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