struttura DRT_SETTINGS (drt.h)

  • Articolo

La struttura DRT_SETTINGS contiene le impostazioni utilizzate dalla tabella di routing distribuita locale.

Sintassi

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;

Members

dwSize

Dimensioni della struttura specificata dal parametro sizeof trovato in DRT_SETTINGS allo scopo di consentire nuovi campi nella struttura nelle versioni future dell'API DRT.

cbKey

Specifica il numero esatto di byte per le chiavi in questa istanza di DRT. Attualmente sono supportati solo 8 byte. Qualsiasi altro valore restituirà E_INVALIDARG tramite la funzione DrtOpen .

bProtocolMajorVersion

Puntatore alla matrice di byte che rappresenta la versione principale del protocollo specificata dall'applicazione. Questo pacchetto viene compresso in ogni pacchetto DRT per identificare la versione dei provider di sicurezza o bootstrap in uso quando una singola istanza DRT supporta più provider di sicurezza o bootstrap.

bProtocolMinorVersion

Puntatore alla matrice di byte che rappresenta la versione secondaria del protocollo specificata dall'applicazione. Questo pacchetto viene compresso in ogni pacchetto DRT per identificare la versione dei provider di sicurezza o bootstrap in uso quando una singola istanza DRT supporta più provider di sicurezza o bootstrap.

ulMaxRoutingAddresses

Specifica il numero massimo di indirizzi registrati da DRT quando un'applicazione registra una chiave. Il valore massimo per questo campo è 4.

pwzDrtInstancePrefix

Questa stringa costituisce la base del nome dell'istanza di DRT. Il nome dell'istanza può essere usato per individuare i contatori delle prestazioni di Windows associati.

hTransport

Gestire un trasporto creato dall'API di creazione del trasporto. Viene utilizzato per aprire una classe DRT con un trasporto specificato dalla struttura DRT_SETTINGS . Attualmente solo UDP IPv6 è supportato tramite DrtCreateIpv6UdpTransport.

pSecurityProvider

Puntatore al provider di sicurezza specificato per l'uso. È possibile ottenere un'istanza del provider di sicurezza delle chiavi derivate chiamando DrtCreateDerivedKeySecurityProvider.

pBootstrapProvider

Puntatore al provider Bootstrap specificato per l'uso. È possibile ottenere un'istanza del provider PNRP Bootstrap chiamando DrtCreatePnrpBootstrapResolver.

eSecurityMode

Specifica la modalità di sicurezza in cui deve funzionare DRT. Tutti i nodi che partecipano a una mesh DRT devono usare la stessa modalità di sicurezza.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 Professional [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Intestazione drt.h

Vedi anche

DrtCreateIpv6UdpTransport

DrtCreatePnrpBootstrapResolver

DrtOpen