Função FwpmSessionEnum0 (fwpmu.h)
A função FwpmSessionEnum0 retorna a próxima página de resultados do enumerador de sessão.
Sintaxe
DWORD FwpmSessionEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_SESSION0 ***entries,
[out] UINT32 *numEntriesReturned
);
Parâmetros
[in] engineHandle
Tipo: HANDLE
Identificador de uma sessão aberta para o mecanismo de filtro. Chame FwpmEngineOpen0 para abrir uma sessão para o mecanismo de filtro.
[in] enumHandle
Tipo: HANDLE
Identificador para uma enumeração de sessão criada por uma chamada para FwpmSessionCreateEnumHandle0.
[in] numEntriesRequested
Tipo: UINT32
O número de entradas de sessão solicitadas.
[out] entries
Tipo: FWPM_SESSION0***
Endereços das entradas de enumeração.
[out] numEntriesReturned
Tipo: UINT32*
O número de objetos de sessão retornados.
Retornar valor
Tipo: DWORD
| Valor/código retornado | Descrição |
|---|---|
|
As sessões foram enumeradas com êxito. |
|
Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte Códigos de erro do WFP para obter detalhes. |
|
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.
A matriz retornada de entradas (mas não as entradas individuais em si) deve ser liberada por uma chamada para FwpmFreeMemory0.
Uma chamada subsequente usando o mesmo identificador de enumeração retornará o próximo conjunto de itens após aqueles no último buffer de saída.
FwpmSessionEnum0 funciona em uma instantâneo das sessões realizadas no momento em que o identificador de enumeração foi criado.
FwpmSessionEnum0 é uma implementação específica de FwpmSessionEnum. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | fwpmu.h |
| Biblioteca | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |