estrutura SERVER_TRANSPORT_INFO_3 (lmserver.h)

Artigo
08/24/2023

A estrutura SERVER_TRANSPORT_INFO_3 contém informações sobre o protocolo de transporte especificado, incluindo nome, endereço e senha (credenciais). Esse nível de informação é válido apenas para a função NetServerTransportAddEx .

Sintaxe

typedef struct _SERVER_TRANSPORT_INFO_3 {
  DWORD  svti3_numberofvcs;
  LMSTR  svti3_transportname;
  LPBYTE svti3_transportaddress;
  DWORD  svti3_transportaddresslength;
  LMSTR  svti3_networkaddress;
  LMSTR  svti3_domain;
  ULONG  svti3_flags;
  DWORD  svti3_passwordlength;
  BYTE   svti3_password[256];
} SERVER_TRANSPORT_INFO_3, *PSERVER_TRANSPORT_INFO_3, *LPSERVER_TRANSPORT_INFO_3;

Membros

svti3_numberofvcs

Tipo: DWORD

O número de clientes conectados ao servidor que estão usando o protocolo de transporte especificado pelo membro svti3_transportname .

svti3_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 forem definidos.

svti3_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 svti3_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).

svti3_transportaddresslength

Tipo: DWORD

O comprimento, em bytes, do membro svti3_transportaddress . Para nomes NetBIOS, o valor desse membro é 16 (decimal).

svti3_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 somente 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 forem definidos.

svti3_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 forem definidos.

svti3_flags

Tipo: ULONG

Esse membro pode ser uma combinação dos valores de bit a seguir definidos no arquivo de cabeçalho Lmserver.h .

Valor	Significado
SVTI2_REMAP_PIPE_NAMES	Se esse valor for definido para um ponto de extremidade, as solicitações de cliente que chegam pelo transporte para abrir um pipe nomeado serão redirecionadas (remapeadas) para o seguinte nome de pipe local: $$\ServerName\PipeName Para obter mais informações sobre o uso desse valor, consulte a seção Comentários.
SVTI2_SCOPED_NAME	Se esse valor for definido para um ponto de extremidade e houver uma tentativa de criar um segundo transporte com o mesmo endereço de rede, mas um nome de transporte diferente e configurações conflitantes para o sinalizador SCOPED, essa criação de transporte falhará. Assim, cada transporte registrado para um determinado endereço de rede deve ter a mesma configuração no escopo. Para obter mais informações sobre o uso desse valor, consulte a seção Comentários. Esse valor é definido no Windows Server 2008 e no Windows Vista com SP1.

Valor

Significado

SVTI2_REMAP_PIPE_NAMES

Se esse valor for definido para um ponto de extremidade, as solicitações de cliente que chegam pelo transporte para abrir um pipe nomeado serão redirecionadas (remapeadas) para o seguinte nome de pipe local:

$$\ServerName\PipeName

Para obter mais informações sobre o uso desse valor, consulte a seção Comentários.

SVTI2_SCOPED_NAME

Se esse valor for definido para um ponto de extremidade e houver uma tentativa de criar um segundo transporte com o mesmo endereço de rede, mas um nome de transporte diferente e configurações conflitantes para o sinalizador SCOPED, essa criação de transporte falhará. Assim, cada transporte registrado para um determinado endereço de rede deve ter a mesma configuração no escopo.

Para obter mais informações sobre o uso desse valor, consulte a seção Comentários.

Esse valor é definido no Windows Server 2008 e no Windows Vista com SP1.

svti3_passwordlength

Tipo: DWORD

O número de bytes válidos no membro svti3_password .

svti3_password[256]

Tipo: BYTE[256]

As credenciais a serem usadas para o novo endereço de transporte. Se o membro svti3_passwordlength for zero, as credenciais do servidor serão usadas.

Comentários

A estrutura SERVER_TRANSPORT_INFO_3 é usada pela função NetServerTransportAddEx para associar o servidor especificado ao protocolo de transporte.

Segue-se um exemplo do uso do valor SVTI2_REMAP_PIPE_NAMES. Chame a função NetServerTransportAddEx para adicionar um transporte ao servidor, especificando o endereço de "MyServer" no membro svti3_transportaddress e SVTI2_REMAP_PIPE_NAMES no membro svti3_flags . Quando um cliente tenta abrir "Pipe" em "\MyServer", o cliente realmente abrirá $$MyServer\Pipe.

Os membros svti3_passwordlength e svti3_password são necessários para que um cliente e um servidor executem a autenticação mútua.

No Windows Server 2008 e no Windows Vista com 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]
Cabeçalho	lmserver.h (inclua Lm.h)