Função FwpmProviderEnum0 (fwpmu.h)
A função FwpmProviderEnum0 retorna a próxima página de resultados do enumerador do provedor.
Sintaxe
DWORD FwpmProviderEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_PROVIDER0 ***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 provedor criada por uma chamada para FwpmProviderCreateEnumHandle0.
[in] numEntriesRequested
Tipo: UINT32
O número de entradas de provedor solicitadas.
[out] entries
Tipo: FWPM_PROVIDER0***
Endereços das entradas de enumeração.
[out] numEntriesReturned
Tipo: UINT32*
O número de objetos de provedor retornados.
Retornar valor
Tipo: DWORD
| Valor/código retornado | Descrição |
|---|---|
|
Os provedores 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.
FwpmProviderEnum0 funciona em um instantâneo dos provedores obtidos no momento em que o identificador de enumeração foi criado.
FwpmProviderEnum0 é uma implementação específica de FwpmProviderEnum. 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 |