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