Função FwpmNetEventEnum1 (fwpmu.h)

Artigo
06/27/2024

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

ObservaçãoFwpmNetEventEnum1 é a implementação específica de FwpmNetEventEnum usada no Windows 7 e posterior. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações. Para o Windows 8, FwpmNetEventEnum2 está disponível. Para o Windows Vista, FwpmNetEventEnum0 está disponível.

Sintaxe

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

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

[in] enumHandle

Tipo: HANDLE

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

[in] numEntriesRequested

Tipo: UINT32

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

[out] entries

Tipo: FWPM_NET_EVENT1***

Endereços de entradas de enumeração.

[out] numEntriesReturned

Tipo: UINT32*

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

Valor de retorno

Tipo: DWORD

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.

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 retornará o próximo conjunto de eventos após aqueles nas entradas de atuais buffer.

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	fwpmu.h
biblioteca	Fwpuclnt.lib
de DLL	Fwpuclnt.dll

Consulte também

FWPM_NET_EVENT1

FwpmNetEventCreateEnumHandle0

de registro em log do WFP

Compartilhar via