Função FwpmProviderContextEnum3 (fwpmu.h)

Retorna a próxima página de resultados do enumerador de contexto do provedor.

Sintaxe

DWORD FwpmProviderContextEnum3(
  HANDLE                 engineHandle,
  HANDLE                 enumHandle,
  UINT32                 numEntriesRequested,
  FWPM_PROVIDER_CONTEXT3 ***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 FwpmProviderContextCreateEnumHandle0.

numEntriesRequested

Tipo: _In_ UINT32

Número de objetos de contexto do provedor solicitados.

entries

Tipo: FWPM_PROVIDER_CONTEXT3 _Outptr_result_buffer_(*numEntriesReturned)***

Os objetos de contexto do provedor retornados.

numEntriesReturned

Tipo: _Out_ UINT32*

O número de objetos de contexto do provedor retornados.

Retornar valor

Tipo: DWORD*

Valor/código retornado	Descrição
ERROR_SUCCESS 0	Os contextos do provedor foram enumerados com êxito.
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 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 entradas individuais em si) chamando FwpmFreeMemory0.

Uma chamada subsequente que usa o mesmo parâmetro enumHandle retornará o próximo conjunto de eventos após os do último buffer de saída.

FwpmProviderContextEnum3 funciona em uma instantâneo dos contextos do provedor feitos no momento em que o identificador de enumeração foi criado.

Requisitos

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