estrutura DRT_SETTINGS (drt.h)
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 |