Função FwpmFilterSubscriptionsGet0 (fwpmu.h)
A função FwpmFilterSubscriptionsGet0 recupera uma matriz de todas as assinaturas de notificação de alteração de filtro atual.
Sintaxe
DWORD FwpmFilterSubscriptionsGet0(
[in] HANDLE engineHandle,
[out] FWPM_FILTER_SUBSCRIPTION0 ***entries,
[out] UINT32 *numEntries
);
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.
[out] entries
Tipo: FWPM_FILTER_SUBSCRIPTION0***
As assinaturas de notificação de alteração de filtro atual.
[out] numEntries
Tipo: UINT32*
O número de entradas retornadas.
Retornar valor
Tipo: DWORD
| Valor/código retornado | Descrição |
|---|---|
|
As assinaturas foram recuperadas 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
A matriz retornada (mas não as entradas individuais na matriz) deve ser liberada por meio de uma chamada para FwpmFreeMemory0.
O chamador precisa FWPM_ACTRL_READ acesso ao contêiner do filtro. Consulte Controle de Acesso para obter mais informações.
FwpmFilterSubscriptionsGet0 é uma implementação específica de FwpmFilterSubscriptionsGet. 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 |