struktur DRT_SETTINGS (drt.h)

  • Artikel

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

Lihat juga

DrtCreateIpv6UdpTransport

DrtCreatePnrpBootstrapResolver

DrtBuka