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 |