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