Compartilhar via

Função FwpmNetEventEnum4 (fwpmk.h)

  • Artigo

A função FwpmNetEventEnum4 retorna a próxima página de resultados do enumerador de eventos de rede.

Sintaxe

NTSTATUS FwpmNetEventEnum4(
  [in]  HANDLE          engineHandle,
  [in]  HANDLE          enumHandle,
  [in]  UINT32          numEntriesRequested,
  [out] FWPM_NET_EVENT4 ***entries,
  [out] UINT32          *numEntriesReturned
);

Parâmetros

[in] engineHandle

Manipule uma sessão aberta para o mecanismo de filtro. Chame FwpmEngineOpen0 para abrir uma sessão no mecanismo de filtro.

[in] enumHandle

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

[in] numEntriesRequested

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

[out] entries

Endereços de entradas de enumeração.

[out] numEntriesReturned

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

Valor de retorno

Código/valor de retorno 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.
FWP_E_* código de erro
0x80320001 — 0x80320039		 Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte de códigos de erro do WFP para obter detalhes.
código de erro RPC_*
0x80010001 — 0x80010122		 Falha ao se comunicar com o mecanismo de firewall local ou remoto.
outros códigos NTSTATUS Ocorreu um erro.

Observações

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

A matriz retornada de entradas (mas não as entradas individuais em si) deve ser liberada por uma chamada para FwpmFreeMemory0.

Uma chamada subsequente que usa o mesmo parâmetro enumHandle retorna o próximo conjunto de eventos após aqueles nas entradas de atuais buffer.

FwpmNetEventEnum4 retorna apenas eventos que foram registrados antes da criação do parâmetro enumHandle. Consulte de log para obter mais informações.

FwpmNetEventEnum4 é uma implementação específica do FwpmNetEventEnum. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows Vista.
da Plataforma de Destino Universal
cabeçalho fwpmk.h
biblioteca fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Consulte também