Skip to content

Latest commit

 

History

History
152 lines (115 loc) · 3.87 KB

nf-fwpmu-fwpmproviderenum0.md

File metadata and controls

152 lines (115 loc) · 3.87 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:fwpmu.FwpmProviderEnum0
FwpmProviderEnum0 function (fwpmu.h)
Returns the next page of results from the provider enumerator.
FwpmProviderEnum0
FwpmProviderEnum0 function [Filtering]
fwp.fwpmproviderenum0_func
fwpmu/FwpmProviderEnum0
fwp\fwpmproviderenum0_func.htm
fwp
7c178688-64f4-49a9-907c-890f7d5030be
12/05/2018
FwpmProviderEnum0, FwpmProviderEnum0 function [Filtering], fwp.fwpmproviderenum0_func, fwpmu/FwpmProviderEnum0
fwpmu.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Fwpuclnt.lib
Fwpuclnt.dll
Windows
19H1
FwpmProviderEnum0
fwpmu/FwpmProviderEnum0
c++
APIRef
kbSyntax
DllExport
Fwpuclnt.dll
FwpmProviderEnum0

FwpmProviderEnum0 function

-description

The FwpmProviderEnum0 function returns the next page of results from the provider enumerator.

-parameters

-param engineHandle [in]

Type: HANDLE

Handle for an open session to the filter engine. Call FwpmEngineOpen0 to open a session to the filter engine.

-param enumHandle [in]

Type: HANDLE

Handle for a provider enumeration created by a call to FwpmProviderCreateEnumHandle0.

-param numEntriesRequested [in]

Type: UINT32

The number of provider entries requested.

-param entries [out]

Type: FWPM_PROVIDER0***

Addresses of the enumeration entries.

-param numEntriesReturned [out]

Type: UINT32*

The number of provider objects returned.

-returns

Type: DWORD

Return code/value Description
ERROR_SUCCESS
0
The providers were enumerated successfully.
FWP_E_* error code
0x80320001—0x80320039
A Windows Filtering Platform (WFP) specific error. See WFP Error Codes for details.
RPC_* error code
0x80010001—0x80010122
Failure to communicate with the remote or local firewall engine.

-remarks

If the numEntriesReturned is less than the numEntriesRequested, the enumeration is exhausted.

The returned array of entries (but not the individual entries themselves) must be freed by a call to FwpmFreeMemory0.

A subsequent call using the same enumeration handle will return the next set of items following those in the last output buffer.

FwpmProviderEnum0 works on a snapshot of the providers taken at the time the enumeration handle was created.

FwpmProviderEnum0 is a specific implementation of FwpmProviderEnum. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

-see-also

FWPM_PROVIDER0

FwpmProviderCreateEnumHandle0