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

注釈

この関数は、トランザクション内から呼び出すことはできません。 FWP_E_TXN_IN_PROGRESSで失敗します。 トランザクションの詳細については、「 オブジェクト管理 」を参照してください。

この関数は、動的セッション内から呼び出すことはできません。 呼び出しは 、FWP_E_DYNAMIC_SESSION_IN_PROGRESSで失敗します。 動的セッションの詳細については、「 オブジェクト管理 」を参照してください。

呼び出し元は 、 IPsec セキュリティ 関連付けデータベースFWPM_ACTRL_ADDアクセスする必要があります。 詳細については、「Access Control」を参照してください。

要件

こちらもご覧ください

IPSEC_TRAFFIC1

IPSEC_VIRTUAL_IF_TUNNEL_INFO0