DRT_SETTINGS 結構 (drt.h)

  • 發行項

DRT_SETTINGS 結構包含本機分散式路由表所使用的設定。

語法

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;

成員

dwSize

DRT_SETTINGS中找到之 sizeof 參數所指定的結構大小，其目的為在DRT API的未來版本中允許結構中的新欄位。

cbKey

指定這個DRT實例中金鑰的確切位元組數目。 目前僅支援8個字節。 任何其他值都會透過DrtOpen函式傳回E_INVALIDARG。

bProtocolMajorVersion

表示應用程式所指定通訊協定主要版本的位元組數位列指標。 這會封裝在每個DRT封包中，以識別單一DRT實例支援多個安全性或啟動程式提供者時所使用的安全性或啟動程式提供者版本。

bProtocolMinorVersion

位元組陣列的指標，表示應用程式所指定的通訊協定次要版本。 這會封裝在每個DRT封包中，以識別單一DRT實例支援多個安全性或啟動程式提供者時所使用的安全性或啟動程式提供者版本。

ulMaxRoutingAddresses

指定當應用程式註冊金鑰時，DRT 註冊的最大位址數目。 此欄位的最大值為 4。

pwzDrtInstancePrefix

此字串會形成DRT實例名稱的基礎。 實例的名稱可用來找出與其相關聯的 Windows 性能計數器。

hTransport

處理傳輸建立 API 所建立的傳輸。 這可用來開啟具有 由 DRT_SETTINGS 結構指定的傳輸的DRT。 目前僅支援透過 DrtCreateIpv6UdpTransport的IPv6 UDP。

pSecurityProvider

指定供使用之安全性提供者的指標。 呼叫 DrtCreateDerivedKeySecurityProvider，即可取得衍生密鑰安全性提供者的實例。

pBootstrapProvider

指定用於之啟動程式提供者的指標。 您可以呼叫 DrtCreatePnrpBootstrapResolver 來取得 PNRP 啟動程式提供者的實例。

eSecurityMode

指定DRT應在其下運作的安全性模式。 參與DRT網格的所有節點都必須使用相同的安全性模式。

規格需求

需求 值
最低支援的用戶端 Windows 7 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
標頭 drt.h

另請參閱

DrtCreateIpv6UdpTransport

DrtCreatePnrpBootstrapResolver

DrtOpen