Función FwpmFilterEnum0 (fwpmu.h)
La función FwpmFilterEnum0 devuelve la siguiente página de resultados del enumerador de filtros.
Sintaxis
DWORD FwpmFilterEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_FILTER0 ***entries,
[out] UINT32 *numEntriesReturned
);
Parámetros
[in] engineHandle
Tipo: HANDLE
Identificador de una sesión abierta en el motor de filtro. Llame a FwpmEngineOpen0 para abrir una sesión en el motor de filtro.
[in] enumHandle
Tipo: HANDLE
Identificador de una enumeración de filtro creada por una llamada a FwpmFilterCreateEnumHandle0.
[in] numEntriesRequested
Tipo: UINT32
Número de objetos de filtro solicitados.
[out] entries
Tipo: FWPM_FILTER0***
Direcciones de entradas de enumeración.
[out] numEntriesReturned
Tipo: UINT32*
Número de objetos de filtro devueltos.
Valor devuelto
Tipo: DWORD
| Código o valor devuelto | Descripción |
|---|---|
|
Los filtros se enumeraron correctamente. |
|
Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información. |
|
Error al comunicarse con el motor de firewall remoto o local. |
Comentarios
Si numEntriesReturned es menor que numEntriesRequested, se agota la enumeración.
La matriz de entradas devuelta (pero no las propias entradas individuales) debe liberarse mediante una llamada a FwpmFreeMemory0.
Una llamada posterior con el mismo identificador de enumeración devolverá el siguiente conjunto de elementos que siguen a los del último búfer de salida.
FwpmFilterEnum0 funciona en una instantánea de los filtros tomados en el momento en que se creó el identificador de enumeración.
FwpmFilterEnum0 es una implementación específica de FwpmFilterEnum. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | fwpmu.h |
| Library | Fwpuclnt.lib |
| Archivo DLL | Fwpuclnt.dll |