IPsecSaContextCreate1 関数 (fwpmu.h)
IPsecSaContextCreate1 関数は、IPsec セキュリティ関連付け (SA) コンテキストを作成します。
構文
DWORD IPsecSaContextCreate1(
[in] HANDLE engineHandle,
[in] const IPSEC_TRAFFIC1 *outboundTraffic,
[in, optional] const IPSEC_VIRTUAL_IF_TUNNEL_INFO0 *virtualIfTunnelInfo,
[out, optional] UINT64 *inboundFilterId,
[out] UINT64 *id
);
パラメーター
[in] engineHandle
型: HANDLE
フィルター エンジンへの開いているセッションを処理します。 FwpmEngineOpen0 を呼び出して、フィルター エンジンへのセッションを開きます。
[in] outboundTraffic
種類: IPSEC_TRAFFIC1*
SA の送信トラフィック。
[in, optional] virtualIfTunnelInfo
種類: IPSEC_VIRTUAL_IF_TUNNEL_INFO0*
仮想インターフェイスのトンネリングに関連する詳細。
[out, optional] inboundFilterId
種類: UINT64*
呼び出し元によって指定された outboundTraffic パラメーターに対応する、キャッシュされた受信フィルターのオプションのフィルター識別子。 ベース フィルター エンジン (BFE) は、受信フィルター識別子をキャッシュし、キャッシュされた値 (使用可能な場合) を返す場合があります。 呼び出し元は、BFE にキャッシュされた値がない場合のケースを処理する必要があります。この場合、このパラメーターは 0 に設定されます。
[out] id
種類: UINT64*
IPsec SA コンテキストの識別子。
戻り値
型: DWORD
| リターン コード/値 | Description |
|---|---|
|
IPsec SA コンテキストが正常に作成されました。 |
|
Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「 WFP エラー コード 」を参照してください。 |
|
リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。 |
注釈
この関数は、トランザクション内から呼び出すことはできません。 FWP_E_TXN_IN_PROGRESSで失敗します。 トランザクションの詳細については、「 オブジェクト管理 」を参照してください。
この関数は、動的セッション内から呼び出すことはできません。 呼び出しは 、FWP_E_DYNAMIC_SESSION_IN_PROGRESSで失敗します。 動的セッションの詳細については、「 オブジェクト管理 」を参照してください。
呼び出し元は 、 IPsec セキュリティ 関連付けデータベースFWPM_ACTRL_ADDアクセスする必要があります。 詳細については、「Access Control」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | fwpmu.h |
| Library | Fwpuclnt.lib |
| [DLL] | Fwpuclnt.dll |