Função FwpmConnectionEnum0 (fwpmu.h)
A função FwpmConnectionEnum0 retorna a próxima página de resultados do enumerador de objeto de conexão.
Sintaxe
DWORD FwpmConnectionEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_CONNECTION0 ***entries,
[out] UINT32 *numEntriesReturned
);
Parâmetros
[in] engineHandle
Tipo: HANDLE
Manipule para 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
Manipular para uma enumeração de contexto de provedor criada por uma chamada para FwpmConnectionCreateEnumHandle0.
[in] numEntriesRequested
Tipo: UINT32
Número de objetos de conexão solicitados.
[out] entries
Tipo: FWPM_CONNECTION0***
Endereços de entradas de enumeração.
[out] numEntriesReturned
Tipo: UINT32*
Retornar valor
Tipo: DWORD
| Valor/código retornado | Descrição |
|---|---|
|
Os objetos de conexão foram enumerados com êxito. |
|
Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte Códigos de erro 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 os do último buffer de saída.
FwpmConnectionEnum0 funciona em uma instantâneo dos objetos de conexão feitos no momento em que o identificador de enumeração foi criado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | fwpmu.h |
| Biblioteca | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |