estrutura DRT_SETTINGS (drt.h)

  • Artigo

A estrutura DRT_SETTINGS contém as configurações utilizadas pela Tabela de Roteamento Distribuído local.

Sintaxe

typedef struct drt_settings_tag {
  DWORD                  dwSize;
  ULONG                  cbKey;
  BYTE                   bProtocolMajorVersion;
  BYTE                   bProtocolMinorVersion;
  ULONG                  ulMaxRoutingAddresses;
  PWSTR                  pwzDrtInstancePrefix;
  HDRT_TRANSPORT         hTransport;
  DRT_SECURITY_PROVIDER  *pSecurityProvider;
  DRT_BOOTSTRAP_PROVIDER *pBootstrapProvider;
  DRT_SECURITY_MODE      eSecurityMode;
} DRT_SETTINGS, *PDRT_SETTINGS;

Membros

dwSize

O tamanho da estrutura especificada pelo parâmetro sizeof encontrado em DRT_SETTINGS com a finalidade de permitir novos campos na estrutura em versões futuras da API DRT.

cbKey

Especifica o número exato de bytes para chaves nesta instância de DRT. Atualmente, há suporte para apenas 8 bytes. Quaisquer outros valores retornarão E_INVALIDARG por meio da função DrtOpen .

bProtocolMajorVersion

Ponteiro para a matriz de bytes que representa a versão principal do protocolo especificada pelo aplicativo. Isso é empacotado em todos os pacotes DRT para identificar a versão dos Provedores de Segurança ou Inicialização em uso quando uma única instância drt dá suporte a vários provedores de segurança ou inicialização.

bProtocolMinorVersion

Ponteiro para a matriz de bytes que representa a versão secundária do protocolo especificada pelo aplicativo. Isso é empacotado em todos os pacotes DRT para identificar a versão dos Provedores de Segurança ou Inicialização em uso quando uma única instância drt dá suporte a vários provedores de segurança ou inicialização.

ulMaxRoutingAddresses

Especifica o número máximo de endereços que o DRT registra quando um aplicativo registra uma chave. O valor máximo para esse campo é 4.

pwzDrtInstancePrefix

Essa cadeia de caracteres forma a base do nome da instância drt. O nome da instância pode ser usado para localizar os contadores de desempenho do Windows associados a ela.

hTransport

Manipule para um transporte criado pela API de criação de transporte. Isso é usado para abrir um DRT com um transporte especificado pela estrutura DRT_SETTINGS . Atualmente, somente O UDP IPv6 tem suporte por meio de DrtCreateIpv6UdpTransport.

pSecurityProvider

Ponteiro para o provedor de segurança especificado para uso. Uma instância do Provedor de Segurança de Chave Derivada pode ser obtida chamando DrtCreateDerivedKeySecurityProvider.

pBootstrapProvider

Ponteiro para o Provedor de Inicialização especificado para uso. Uma instância do Provedor de Inicialização PNRP pode ser obtida chamando DrtCreatePnrpBootstrapResolver.

eSecurityMode

Especifica o modo de segurança no qual o DRT deve operar. Todos os nós que participam de uma malha DRT devem usar o mesmo modo de segurança.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho drt.h

Confira também

DrtCreateIpv6UdpTransport

DrtCreatePnrpBootstrapResolver

DrtOpen