Função FwpmCalloutEnum0 (fwpmu.h)
A função FwpmCalloutEnum0 retorna a próxima página de resultados do enumerador de texto explicativo.
Sintaxe
DWORD FwpmCalloutEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_CALLOUT0 ***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
Manipule para uma enumeração de texto explicativo criada por uma chamada para FwpmCalloutCreateEnumHandle0.
[in] numEntriesRequested
Tipo: UINT32
O número de objetos de texto explicativo solicitados.
[out] entries
Tipo: FWP_CALLOUT0***
Endereços das entradas de enumeração.
[out] numEntriesReturned
Tipo: UINT32*
O número de textos explicativos retornados.
Valor retornado
Tipo: DWORD
| Valor/código retornado | Descrição |
|---|---|
|
Os textos explicativos 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.
FwpmCalloutEnum0 funciona em uma instantâneo dos textos explicativos feitos no momento em que o identificador de enumeração foi criado.
FwpmCalloutEnum0 é uma implementação específica de FwpmCalloutEnum. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.
Requisitos
| 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 |