FwpmNetEventEnum2 関数 (fwpmu.h)
FwpmNetEventEnum2 関数は、ネットワーク イベント列挙子から結果の次のページを返します。
注FwpmNetEventEnum2 は、Windows 8 以降で使用される FwpmNetEventEnum の特定の実装です。 詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象 とする」を参照してください。 Windows 7 の場合、 FwpmNetEventEnum1 を使用できます。 Windows Vista の場合、 FwpmNetEventEnum0 を使用できます。
構文
DWORD FwpmNetEventEnum2(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_NET_EVENT2 ***entries,
[out] UINT32 *numEntriesReturned
);
パラメーター
[in] engineHandle
型: HANDLE
フィルター エンジンへの開いているセッションのハンドル。 FwpmEngineOpen0 を呼び出して、フィルター エンジンへのセッションを開きます。
[in] enumHandle
型: HANDLE
FwpmNetEventCreateEnumHandle0 の呼び出しによって作成されたネットワーク イベント列挙のハンドル。
[in] numEntriesRequested
型: UINT32
要求された列挙エントリの数。
[out] entries
種類: FWPM_NET_EVENT2***
列挙エントリのアドレス。
[out] numEntriesReturned
種類: UINT32*
返される列挙エントリの数。
戻り値
型: DWORD
| リターン コード/値 | Description |
|---|---|
|
ネットワーク イベントが正常に列挙されました。 |
|
ネットワーク診断イベントのコレクションは無効になっています。 FwpmEngineSetOption0 を呼び出して有効にします。 |
|
Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「 WFP エラー コード 」を参照してください。 |
|
リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。 |
注釈
numEntriesReturned が numEntriesRequested より小さい場合、列挙は使い果たされます。
FwpmFreeMemory0 の呼び出しによって、返されるエントリの配列 (個々のエントリ自体ではない) を解放する必要があります。
同じ enumHandle パラメーターを使用する後続の呼び出しでは、現在のエントリ バッファー内のイベントに続くイベントの次のセット が 返されます。
FwpmNetEventEnum2 は、 enumHandle パラメーターの作成前にログに記録されたイベントのみを返します。 詳細については、「Logging」 (ログ記録) を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | fwpmu.h |
| Library | Fwpuclnt.lib |
| [DLL] | Fwpuclnt.dll |