Compartilhar via


Função FwpmNetEventEnum1 (fwpmu.h)

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