Função NetServerTransportAddEx (lmserver.h)
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 |
|---|---|
|
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 . |
|
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 . |
|
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 . |
|
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 |
|---|---|
|
O usuário não tem acesso às informações solicitadas. |
|
Existe um nome duplicado na rede. |
|
Não foi possível encontrar o nome de domínio na rede. |
|
O valor especificado para o parâmetro de nível é inválido. |
|
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. |
|
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 |
Confira também
Funções de gerenciamento de rede
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de