IPsecSaContextEnum1 関数 (fwpmu.h)
IPsecSaContextEnum1 関数は、IPsec セキュリティ関連付け (SA) コンテキスト列挙子から結果の次のページを返します。
メモIPsecSaContextEnum1 は、Windows 7 以降で使用される IPsecSaContextEnum の特定の実装です。 詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象 とする」を参照してください。 Windows Vista の場合、 IPsecSaContextEnum0 を使用できます。
構文
DWORD IPsecSaContextEnum1(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] IPSEC_SA_CONTEXT1 ***entries,
[out] UINT32 *numEntriesReturned
);
パラメーター
[in] engineHandle
型: HANDLE
フィルター エンジンへの開いているセッションを処理します。 FwpmEngineOpen0 を呼び出して、フィルター エンジンへのセッションを開きます。
[in] enumHandle
型: HANDLE
IPsecSaContextCreateEnumHandle0 によって返される SA コンテキスト列挙のハンドル。
[in] numEntriesRequested
種類: UINT32
要求された SA コンテキストの数。
[out] entries
種類: IPSEC_SA_CONTEXT1***
列挙エントリのアドレス。
[out] numEntriesReturned
型: UINT32*
返される SA コンテキストの数。
戻り値
型: DWORD
リターン コード/値 | Description |
---|---|
|
IPsec SA コンテキストが正常に列挙されました。 |
|
Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「 WFP エラー コード 」を参照してください。 |
|
リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。 |
解説
numEntriesReturned が numEntriesRequested より小さい場合、列挙体は使い果たされます。
返されるエントリの配列 (個々のエントリ自体ではなく) は 、FwpmFreeMemory0 の呼び出しによって解放する必要があります。
要件
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | fwpmu.h |
Library | Fwpuclnt.lib |
[DLL] | Fwpuclnt.dll |