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 API で構造体の新しいフィールドを許可する目的で、DRT_SETTINGSで見つかった sizeof パラメーターで指定された構造体のサイズ。

cbKey

この DRT インスタンス内のキーの正確なバイト数を指定します。 現在サポートされているバイト数は 8 バイトのみです。 その他の値は、DrtOpen 関数を介してE_INVALIDARGを返します。

bProtocolMajorVersion

アプリケーションで指定されたプロトコル メジャー バージョンを表すバイト配列へのポインター。 これは、1 つの DRT インスタンスが複数のセキュリティ プロバイダーまたはブートストラップ プロバイダーをサポートしている場合に使用されているセキュリティ プロバイダーまたはブートストラップ プロバイダーのバージョンを識別するために、すべての DRT パケットにパックされます。

bProtocolMinorVersion

アプリケーションで指定されたプロトコル マイナー バージョンを表すバイト配列へのポインター。 これは、1 つの DRT インスタンスが複数のセキュリティ プロバイダーまたはブートストラップ プロバイダーをサポートしている場合に使用されているセキュリティ プロバイダーまたはブートストラップ プロバイダーのバージョンを識別するために、すべての DRT パケットにパックされます。

ulMaxRoutingAddresses

アプリケーションがキーを登録するときに DRT が登録するアドレスの最大数を指定します。 このフィールドの最大値は 4 です。

pwzDrtInstancePrefix

この文字列は、DRT インスタンスの名前の基礎を形成します。 インスタンスの名前を使用して、それに関連付けられている Windows パフォーマンス カウンターを見つけることができます。

hTransport

トランスポート作成 API によって作成されたトランスポートへのハンドル。 これは、 DRT_SETTINGS 構造体で指定されたトランスポートを使用して DRT を開くために使用されます。 現在、 DrtCreateIpv6UdpTransport を介してサポートされているのは IPv6 UDP のみです。

pSecurityProvider

使用するために指定されたセキュリティ プロバイダーへのポインター。 派生キー セキュリティ プロバイダーのインスタンスは、 DrtCreateDerivedKeySecurityProvider を呼び出すことで取得できます。

pBootstrapProvider

使用するために指定されたブートストラップ プロバイダーへのポインター。 PNRP ブートストラップ プロバイダーのインスタンスは、 DrtCreatePnrpBootstrapResolver を呼び出すことで取得できます。

eSecurityMode

DRT が動作するセキュリティ モードを指定します。 DRT メッシュに参加しているすべてのノードは、同じセキュリティ モードを使用する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 7 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
Header	drt.h

こちらもご覧ください

DrtCreateIpv6UdpTransport

DrtCreatePnrpBootstrapResolver

DrtOpen