IPSEC_SA_BUNDLE1 構造体 (ipsectypes.h)
IPSEC_SA_BUNDLE1構造体は、IPsec セキュリティ アソシエーション (SA) バンドルに関する情報を格納するために使用されます。 IPSEC_SA_BUNDLE0 を使用できます。
構文
typedef struct IPSEC_SA_BUNDLE1_ {
UINT32 flags;
IPSEC_SA_LIFETIME0 lifetime;
UINT32 idleTimeoutSeconds;
UINT32 ndAllowClearTimeoutSeconds;
IPSEC_ID0 *ipsecId;
UINT32 napContext;
UINT32 qmSaId;
UINT32 numSAs;
IPSEC_SA0 *saList;
IPSEC_KEYMODULE_STATE0 *keyModuleState;
FWP_IP_VERSION ipVersion;
union {
UINT32 peerV4PrivateAddress;
};
UINT64 mmSaId;
IPSEC_PFS_GROUP pfsGroup;
GUID saLookupContext;
UINT64 qmFilterId;
} IPSEC_SA_BUNDLE1;
メンバー
flags
次の値の組み合わせ。
lifetime
IPSEC_SA_LIFETIME0で指定されたバンドル内のすべての CA の有効期間。
idleTimeoutSeconds
(トラフィックが非アクティブであるため) バンドル内の CA がアイドル状態になり、期限切れになるまでのタイムアウト (秒単位)。
ndAllowClearTimeoutSeconds
タイムアウト (秒単位)。 その後、IPsec SA はクリアで受信するパケットの受け入れを停止する必要があります。
ネゴシエーション検出に使用されます。
ipsecId
オプションの IPsec ID 情報を含む IPSEC_ID0 構造体へのポインター。
napContext
ネットワーク アクセス ポイント (NAP) ピアの資格情報。
qmSaId
有効期限が切れる SA を選択するときに IPsec によって使用される SA 識別子。 IPsec SA ペアの場合、 qmSaId は、開始側マシンと応答側マシン間、およびインバウンドおよびアウトバウンド SA バンドル間で同じである必要があります。 IPsec ペアが異なる場合、 qmSaId は 異なる必要があります。
numSAs
バンドル内の CA の数。 指定できる値は 1 と 2 のみです。 AH と ESP の CA を指定する場合にのみ、2 を使用します。
saList
バンドル内の IPsec CA の配列。 AH と ESP SA の場合は、ESP SA にインデックス 0 を、AH SA の場合はインデックス 1 を使用します。
詳細については、「 IPSEC_SA0 」を参照してください。
keyModuleState
IPSEC_KEYMODULE_STATE0で指定されたオプションのキーモジュール固有の情報。
ipVersion
FWP_IP_VERSIONで指定された IP バージョン。
peerV4PrivateAddress
ipVersion がFWP_IP_VERSION_V4されている場合に使用できます。 ピアが NAT デバイスの背後にある場合、このメンバーはピアのプライベート アドレスを格納します。
mmSaId
この ID を使用して、この IPsec SA を生成した IKE SA と関連付けます。
pfsGroup
この SA に対してクイック モードの完全前方秘密 (PFS) が有効になっているかどうかを指定します。有効な場合は、PFS に使用された Diffie-Hellman グループが含まれます。
詳細については、「 IPSEC_PFS_GROUP 」を参照してください。
saLookupContext
SA からその SA 経由でフローするデータ接続に伝達される SA 参照コンテキスト。 これは、Winsock API WSAQuerySocketSecurity 関数を使用してソケット セキュリティ プロパティに対してクエリを実行する任意のアプリケーションで使用でき、アプリケーションが接続の詳細な IPsec 認証情報を取得できるようにします。
qmFilterId
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| Header | ipsectypes.h |