estrutura SERVER_TRANSPORT_INFO_2 (lmserver.h)

Artigo
08/24/2023

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 .

Valor	Significado
SVTI2_REMAP_PIPE_NAMES	Se esse valor for definido para um ponto de extremidade, as solicitações do 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 do 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.

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)