FwpmProviderContextEnum1 関数 (fwpmu.h)
FwpmProviderContextEnum1 関数は、プロバイダー コンテキスト列挙子から結果の次のページを返します。
構文
DWORD FwpmProviderContextEnum1(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_PROVIDER_CONTEXT1 ***entries,
[out] UINT32 *numEntriesReturned
);
パラメーター
[in] engineHandle
型: HANDLE
フィルター エンジンへの開いているセッションのハンドル。 FwpmEngineOpen0 を呼び出して、フィルター エンジンへのセッションを開きます。
[in] enumHandle
型: HANDLE
FwpmProviderContextCreateEnumHandle0 の呼び出しによって作成されたプロバイダー コンテキスト列挙のハンドル。
[in] numEntriesRequested
型: UINT32
要求されたプロバイダー コンテキスト オブジェクトの数。
[out] entries
種類: FWPM_PROVIDER_CONTEXT1***
返されるプロバイダー コンテキスト オブジェクト。
[out] numEntriesReturned
種類: UINT32*
返されるプロバイダー コンテキスト オブジェクトの数。
戻り値
型: DWORD
リターン コード/値 | Description |
---|---|
|
プロバイダー コンテキストが正常に列挙されました。 |
|
Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「 WFP エラー コード 」を参照してください。 |
|
リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。 |
注釈
numEntriesReturned が numEntriesRequested より小さい場合、列挙は使い果たされます。
FwpmFreeMemory0 の呼び出しによって、返されるエントリの配列 (個々のエントリ自体ではない) を解放する必要があります。
同じ列挙ハンドルを使用する後続の呼び出しでは、最後の出力バッファー内の項目に続く項目の次のセットが返されます。
FwpmProviderContextEnum1 は、列挙ハンドルの作成時に取得されたプロバイダー コンテキストのスナップショットで動作します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | fwpmu.h |
Library | Fwpuclnt.lib |
[DLL] | Fwpuclnt.dll |