Función FwpmNetEventEnum1 (fwpmu.h)

  • Artículo

La función FwpmNetEventEnum1 devuelve la siguiente página de resultados del enumerador de eventos de red.

NotafwpmNetEventEnum1 es la implementación específica de FwpmNetEventEnum que se usa en Windows 7 y versiones posteriores. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información. Para Windows 8, fwpmNetEventEnum2 está disponible. Para Windows Vista, fwpmNetEventEnum0 está disponible.
 

Sintaxis

DWORD FwpmNetEventEnum1(
  [in]  HANDLE          engineHandle,
  [in]  HANDLE          enumHandle,
  [in]  UINT32          numEntriesRequested,
  [out] FWPM_NET_EVENT1 ***entries,
  [out] UINT32          *numEntriesReturned
);

Parámetros

[in] engineHandle

Tipo: HANDLE de

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 de

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

[in] numEntriesRequested

Tipo: UINT32

Número de entradas de enumeración solicitadas.

[out] entries

Tipo: FWPM_NET_EVENT1***

Direcciones de entradas de enumeración.

[out] numEntriesReturned

Tipo: UINT32*

Número de entradas de enumeración devueltas.

Valor devuelto

Tipo: DWORD de

Código y valor devueltos 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.
FWP_E_* de código de error
0x80320001: 0x80320039
 Error específico de la Plataforma de filtrado de Windows (PMA). Consulte códigos de error de PMA para obtener más información.
RPC_* código de error
0x80010001: 0x80010122
 Error al comunicarse con el motor de firewall remoto o local.

Observaciones

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

La matriz de entradas devuelta (pero no las entradas individuales) debe liberarse mediante una llamada a FwpmFreeMemory0.

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

FwpmNetEventEnum1 devuelve solo los eventos que se registraron antes de la creación del parámetro enumHandle. Consulte de registro para obtener más información.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 7 [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 R2 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de fwpmu.h
biblioteca de Fwpuclnt.lib
DLL de Fwpuclnt.dll

Consulte también

FWPM_NET_EVENT1

FwpmNetEventCreateEnumHandle0

de registro DE PMA