Compartir a través de

Función FwpmNetEventEnum5 (fwpmu.h)

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

Sintaxis

DWORD FwpmNetEventEnum5(
  HANDLE          engineHandle,
  HANDLE          enumHandle,
  UINT32          numEntriesRequested,
  FWPM_NET_EVENT5 ***entries,
  UINT32          *numEntriesReturned
);

Parámetros

engineHandle

Tipo: _In_ HANDLE

Identificador de una sesión abierta con el motor de filtro. 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_EVENT5***

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 recopilació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 propias entradas individuales) mediante una llamada a FwpmFreeMemory0.

Una llamada posterior que usa el mismo parámetro enumHandle devolverá el siguiente conjunto de eventos que siguen a los del búfer de entradas actuales.

FwpmNetEventEnum5 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
  • Last updated on