Compartilhar via

Função FwpmNetEventEnum5 (fwpmu.h)

  • Artigo

Recupera a próxima página de resultados do enumerador de eventos de rede.

Sintaxe

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

Parâmetros

engineHandle

Tipo: _In_ HANDLE

Um identificador para uma sessão aberta com o mecanismo de filtro. Para abrir uma sessão com o mecanismo de filtro, chame FwpmEngineOpen0.

enumHandle

Tipo: _In_ HANDLE

Um identificador para uma enumeração de evento de rede criada por uma chamada para FwpmNetEventCreateEnumHandle0.

numEntriesRequested

Tipo: _In_ UINT32

O número de entradas de enumeração solicitadas.

entries

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

Endereços de entradas de enumeração.

numEntriesReturned

Tipo: _Out_ UINT32*

O número de entradas de enumeração retornadas.

Retornar valor

Valor/código retornado Descrição
ERROR_SUCCESS
0		 Os eventos de rede foram enumerados com êxito.
FWP_E_NET_EVENTS_DISABLED
0x80320013		 A coleção de eventos de diagnóstico de rede está desabilitada.
Chame FwpmEngineSetOption0 para habilitá-lo.
código de erro FWP_E_*
0x80320001 — 0x80320039		 Um erro específico da Plataforma de Filtragem do Windows (WFP). Para obter detalhes, consulte Códigos de erro do WFP.
código de erro RPC_*
0x80010001 — 0x80010122		 Falha ao se comunicar com o mecanismo de firewall remoto ou local.

Comentários

Se numEntriesReturned for menor que numEntriesRequested, a enumeração será esgotada.

Você deve liberar a matriz de entradas retornada (mas não as próprias entradas individuais) chamando FwpmFreeMemory0.

Uma chamada subsequente que usa o mesmo parâmetro enumHandle retornará o próximo conjunto de eventos após aqueles no buffer de entradas atual.

FwpmNetEventEnum5 retorna apenas eventos que foram registrados antes da criação do parâmetro enumHandle . Para obter mais informações, consulte Registro em log.

Requisitos

Requisito Valor
Cabeçalho fwpmu.h
Biblioteca Fwpuclnt.lib
DLL Fwpuclnt.dll