Share via

IPsecKeyManagerAddAndRegister0 関数 (fwpmu.h)

  • [アーティクル]

IPsecKeyManagerAddAndRegister0 関数は、信頼された中間エージェント (TIA) を IPsec に登録します。

構文

DWORD IPsecKeyManagerAddAndRegister0(
  [in]  HANDLE                             engineHandle,
  [in]  const IPSEC_KEY_MANAGER0           *keyManager,
  [in]  const IPSEC_KEY_MANAGER_CALLBACKS0 *keyManagerCallbacks,
  [out] HANDLE                             *keyMgmtHandle
);

パラメーター

[in] engineHandle

型: HANDLE

フィルター エンジンへの開いているセッションのハンドル。 FwpmEngineOpen0 を呼び出して、フィルター エンジンへのセッションを開きます。

[in] keyManager

型: const IPSEC_KEY_MANAGER0*

IPsec が呼び出すキー管理コールバックのセット。

[in] keyManagerCallbacks

型: const IPSEC_KEY_MANAGER_CALLBACKS0*

SA ネゴシエーションのさまざまな段階で IPsec によって呼び出される必要があるコールバックのセット。

[out] keyMgmtHandle

種類: HANDLE*

新しく作成された登録のアドレス。

戻り値

型: DWORD

リターン コード/値 Description
ERROR_SUCCESS
0
 TIA が正常に登録されました。
FWP_E_* エラー コード
0x80320001 — 0x80320039
 Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「 WFP エラー コード 」を参照してください。
RPC_* エラー コード
0x80010001 — 0x80010122
 リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。
FWP_E_ALREADY_EXISTS
0x80320009L
 キーをディクテーションするために別の TIA が既に登録されているため、TIA は正常に登録されませんでした。
FWP_E_INVALID_INTERVAL
0x80320021L
 keyDictationTimeoutHint が最大許容値 10 秒を超えたため、TIA が正常に登録されませんでした。
SEC_E_CANNOT_INSTALL
0x80090307L
 バイナリ イメージで IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY プロパティが設定されていないため、TIA が正常に登録されませんでした。

注釈

IPSEC_KEY_MANAGER_FLAG_DICTATE_KEY フラグが keyManager に設定されている場合は、keyManagerCallbacks の 3 つのコールバック メンバーすべてを指定する必要があります。それ以外の場合は、keyNotify コールバックのみを指定する必要があります

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

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー fwpmu.h
Library Fwpuclnt.lib
[DLL] Fwpuclnt.dll

こちらもご覧ください

IPSEC_KEY_MANAGER0

IPSEC_KEY_MANAGER_CALLBACKS0

WFP 関数