Función FwpmNetEventEnum4 (fwpmu.h)

Recupera la siguiente página de resultados del enumerador de eventos de red.

Sintaxis

DWORD FwpmNetEventEnum4(
  HANDLE          engineHandle,
  HANDLE          enumHandle,
  UINT32          numEntriesRequested,
  FWPM_NET_EVENT4 ***entries,
  UINT32          *numEntriesReturned
);

Parámetros

engineHandle

Tipo: _In_ HANDLE

Identificador de una sesión abierta con el motor de filtros. Para abrir una sesión con el motor de filtro, llame a FwpmEngineOpen0.

enumHandle

Tipo: _In_ HANDLE

Identificador de una enumeración de eventos de red creada por una llamada a FwpmNetEventCreateEnumHandle0.

numEntriesRequested

Tipo: _In_ UINT32

Número de entradas de enumeración solicitadas.

entries

Tipo: _Outptr_result_buffer_(*numEntriesReturned) const FWPM_NET_EVENT4***

Direcciones de entradas de enumeración.

numEntriesReturned

Tipo: _Out_ UINT32*

Número de entradas de enumeración devueltas.

Valor devuelto

Código o valor devuelto	Descripción
ERROR_SUCCESS 0	Los eventos de red se enumeraron correctamente.
FWP_E_NET_EVENTS_DISABLED 0x80320013	La colección de eventos de diagnóstico de red está deshabilitada.
Llame a FwpmEngineSetOption0 para habilitarlo.
código de error FWP_E_* 0x80320001: 0x80320039	Error específico de la Plataforma de filtrado de Windows (PMA). Para obtener más información, consulte Códigos de error de PMA.
RPC_* código de error* 0x80010001: 0x80010122	Error al comunicarse con el motor de firewall remoto o local.

Comentarios

Si numEntriesReturned es menor que numEntriesRequested, se agota la enumeración.

Debe liberar la matriz de entradas devuelta (pero no las entradas individuales) llamando a FwpmFreeMemory0.

Una llamada posterior que use el mismo parámetro enumHandle devolverá el siguiente conjunto de eventos después de los del búfer de entradas actuales.

FwpmNetEventEnum4 devuelve solo los eventos registrados antes de la creación del parámetro enumHandle . Para obtener más información, consulta Registro.

Requisitos

Requisito	Valor
Header	fwpmu.h
Library	Fwpuclnt.lib
Archivo DLL	Fwpuclnt.dll