estrutura SERVER_TRANSPORT_INFO_2 (lmserver.h)
A estrutura SERVER_TRANSPORT_INFO_2 contém informações sobre o protocolo de transporte especificado, incluindo o nome e o endereço do transporte. Esse nível de informação é válido apenas para a função NetServerTransportAddEx .
Sintaxe
typedef struct _SERVER_TRANSPORT_INFO_2 {
DWORD svti2_numberofvcs;
LMSTR svti2_transportname;
LPBYTE svti2_transportaddress;
DWORD svti2_transportaddresslength;
LMSTR svti2_networkaddress;
LMSTR svti2_domain;
ULONG svti2_flags;
} SERVER_TRANSPORT_INFO_2, *PSERVER_TRANSPORT_INFO_2, *LPSERVER_TRANSPORT_INFO_2;
Membros
svti2_numberofvcs
Tipo: DWORD
O número de clientes conectados ao servidor que estão usando o protocolo de transporte especificado pelo membro svti2_transportname .
svti2_transportname
Tipo: LMSTR
Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome de um dispositivo de transporte; por exemplo,
\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}
Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiverem definidos.
svti2_transportaddress
Tipo: LPBYTE
Um ponteiro para uma variável que contém o endereço que o servidor está usando no dispositivo de transporte especificado pelo membro svti2_transportname .
Esse membro geralmente é o nome NetBIOS que o servidor está usando. Nessas instâncias, o nome deve ter 16 caracteres e o último caractere deve ser um caractere em branco (0x20).
svti2_transportaddresslength
Tipo: DWORD
O comprimento, em bytes, do membro svti2_transportaddress . Para nomes NetBIOS, o valor desse membro é 16 (decimal).
svti2_networkaddress
Tipo: LMSTR
Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o endereço que o adaptador de rede está usando. A cadeia de caracteres é específica do transporte.
Você pode recuperar esse valor apenas com uma chamada para a função NetServerTransportEnum . Você não pode definir esse valor com uma chamada para a função NetServerTransportAdd ou a função NetServerTransportAddEx .)
Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiverem definidos.
svti2_domain
Tipo: LMSTR
Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome do domínio ao qual o servidor deve anunciar sua presença. (Quando você chama NetServerTransportEnum, esse membro é o nome do domínio para o qual o servidor está anunciando sua presença.)
Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiverem definidos.
svti2_flags
Tipo: ULONG
Esse membro pode ser uma combinação dos valores de bit a seguir definidos no arquivo de cabeçalho Lmserver.h .
Comentários
A estrutura SERVER_TRANSPORT_INFO_2 é usada pela função NetServerTransportAddEx para associar o servidor especificado ao protocolo de transporte.
Um exemplo do uso do valor SVTI2_REMAP_PIPE_NAMES segue. Chame a função NetServerTransportAddEx para adicionar um transporte ao servidor, especificando o endereço de "MyServer" no membro svti2_transportaddress e SVTI2_REMAP_PIPE_NAMES no membro svti2_flags . Quando um cliente tenta abrir "Pipe" em "\MyServer", o cliente realmente abrirá $$MyServer\Pipe.
No Windows Server 2008 e no Windows Vista com SP1, cada nome registrado com o SRV (servidor de arquivos remoto) do Windows é designado como um nome com escopo ou um nome sem escopo. Cada compartilhamento adicionado ao sistema será anexado a todos os nomes sem 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 NetServerTransportAddExcom o parâmetro level 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 membro shi503_servername 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] |
Cabeçalho | lmserver.h (inclua Lm.h) |
Confira também
Visão geral do gerenciamento de rede