次の方法で共有

FwpmNetEventEnum5 関数 (fwpmu.h)

ネットワーク イベント列挙子から結果の次のページを取得します。

構文

DWORD FwpmNetEventEnum5(
  HANDLE          engineHandle,
  HANDLE          enumHandle,
  UINT32          numEntriesRequested,
  FWPM_NET_EVENT5 ***entries,
  UINT32          *numEntriesReturned
);

パラメーター

engineHandle

型: _In_ HANDLE

フィルター エンジンとのオープン セッションへのハンドル。 フィルター エンジンとのセッションを開くには、 FwpmEngineOpen0 を呼び出します。

enumHandle

型: _In_ HANDLE

FwpmNetEventCreateEnumHandle0 の呼び出しによって作成されたネットワーク イベント列挙へのハンドル。

numEntriesRequested

型: _In_ UINT32

要求された列挙エントリの数。

entries

型: _Outptr_result_buffer_(*numEntriesReturned) const FWPM_NET_EVENT5***

列挙エントリのアドレス。

numEntriesReturned

型: _Out_ UINT32*

返される列挙エントリの数。

戻り値

リターン コード/値 説明
ERROR_SUCCESS
0		 ネットワーク イベントが正常に列挙されました。
FWP_E_NET_EVENTS_DISABLED
0x80320013		 ネットワーク診断イベントのコレクションは無効になっています。
FwpmEngineSetOption0 を呼び出して有効にします。
FWP_E_* エラー コード
0x80320001 — 0x80320039		 Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「 WFP エラー コード」を参照してください。
RPC_* エラー コード
0x80010001 — 0x80010122		 リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。

注釈

numEntriesReturned が numEntriesRequested より小さい場合、列挙体は使い果たされます。

FwpmFreeMemory0 を呼び出して、返されるエントリの配列 (個々のエントリ自体は解放しない) を解放する必要があります。

同じ enumHandle パラメーターを使用する後続の呼び出しでは、現在のエントリ バッファー内のイベントに続くイベントの次のセット が 返されます。

FwpmNetEventEnum5 は、 enumHandle パラメーターの作成前にログに記録されたイベントのみを返します。 詳細については、「 ログ記録」を参照してください。

要件

要件 値
Header fwpmu.h
Library Fwpuclnt.lib
[DLL] Fwpuclnt.dll
  • Last updated on