struktur DRT_SETTINGS (drt.h)
Struktur DRT_SETTINGS berisi pengaturan yang digunakan oleh Tabel Perutean Terdistribusi lokal.
Sintaks
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;
Anggota
dwSize
Ukuran struktur yang ditentukan oleh parameter sizeof yang ditemukan di DRT_SETTINGS dengan tujuan memungkinkan bidang baru dalam struktur dalam versi DRT API di masa mendatang.
cbKey
Menentukan jumlah byte yang tepat untuk kunci dalam instans DRT ini. Saat ini hanya 8 byte yang didukung. Nilai lain akan mengembalikan E_INVALIDARG melalui fungsi DrtOpen .
bProtocolMajorVersion
Penunjuk ke array byte yang mewakili versi utama protokol yang ditentukan oleh aplikasi. Ini dikemas dalam setiap paket DRT untuk mengidentifikasi versi Penyedia Keamanan atau Bootstrap yang digunakan ketika satu instans DRT mendukung beberapa Penyedia Keamanan atau Bootstrap.
bProtocolMinorVersion
Penunjuk ke array byte yang mewakili protokol versi minor yang ditentukan oleh aplikasi. Ini dikemas dalam setiap paket DRT untuk mengidentifikasi versi Penyedia Keamanan atau Bootstrap yang digunakan ketika satu instans DRT mendukung beberapa Penyedia Keamanan atau Bootstrap.
ulMaxRoutingAddresses
Menentukan jumlah maksimum alamat yang didaftarkan DRT saat aplikasi mendaftarkan kunci. Nilai maksimum untuk bidang ini adalah 4.
pwzDrtInstancePrefix
String ini membentuk dasar nama instans DRT. Nama instans dapat digunakan untuk menemukan penghitung kinerja Windows yang terkait dengannya.
hTransport
Tangani ke transportasi yang dibuat oleh API pembuatan transportasi. Ini digunakan untuk membuka DRT dengan transportasi yang ditentukan oleh struktur DRT_SETTINGS . Saat ini hanya UDP IPv6 yang didukung melalui DrtCreateIpv6UdpTransport.
pSecurityProvider
Penunjuk ke penyedia keamanan yang ditentukan untuk digunakan. Instans Penyedia Keamanan Kunci Turunan dapat diperoleh dengan memanggil DrtCreateDerivedKeySecurityProvider.
pBootstrapProvider
Penunjuk ke Penyedia Bootstrap yang ditentukan untuk digunakan. Instans Penyedia Bootstrap PNRP dapat diperoleh dengan memanggil DrtCreatePnrpBootstrapResolver.
eSecurityMode
Menentukan mode keamanan yang harus dioperasikan DRT. Semua simpul yang berpartisipasi dalam jala DRT harus menggunakan mode keamanan yang sama.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 7 Professional [khusus aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
| Header | drt.h |