FwpmProviderContextEnum3 関数 (fwpmu.h)

  • [アーティクル]

プロバイダー コンテキスト列挙子から結果の次のページを返します。

構文

DWORD FwpmProviderContextEnum3(
  HANDLE                 engineHandle,
  HANDLE                 enumHandle,
  UINT32                 numEntriesRequested,
  FWPM_PROVIDER_CONTEXT3 ***entries,
  UINT32                 *numEntriesReturned
);

パラメーター

engineHandle

型: _In_ HANDLE

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

enumHandle

型: _In_ HANDLE

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

numEntriesRequested

型: _In_ UINT32

要求されたプロバイダー コンテキスト オブジェクトの数。

entries

型: _Outptr_result_buffer_(*numEntriesReturned) FWPM_PROVIDER_CONTEXT3***

返されるプロバイダー コンテキスト オブジェクト。

numEntriesReturned

型: _Out_ UINT32*

返されるプロバイダー コンテキスト オブジェクトの数。

戻り値

種類: DWORD*

リターン コード/値 説明
ERROR_SUCCESS
0		 プロバイダー コンテキストが正常に列挙されました。
FWP_E_* エラー コード
0x80320001 — 0x80320039		 Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「 WFP エラー コード」を参照してください。
RPC_* エラー コード
0x80010001 — 0x80010122		 リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。

注釈

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

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

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

FwpmProviderContextEnum3 は、列挙ハンドルの作成時に取得されたプロバイダー コンテキストのスナップショットで機能します。

要件

要件 値
Header fwpmu.h
Library Fwpuclnt.lib
[DLL] Fwpuclnt.dll