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 |
|---|---|
|
TIA が正常に登録されました。 |
|
Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「 WFP エラー コード 」を参照してください。 |
|
リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。 |
|
キーをディクテーションするために別の TIA が既に登録されているため、TIA は正常に登録されませんでした。 |
|
keyDictationTimeoutHint が最大許容値 10 秒を超えたため、TIA が正常に登録されませんでした。 |
|
バイナリ イメージで 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 |