Função FwpmFilterSubscribeChanges0 (fwpmu.h)
A função FwpmFilterSubscribeChanges0 é usada para solicitar a entrega de notificações sobre alterações em um filtro específico.
Sintaxe
DWORD FwpmFilterSubscribeChanges0(
[in] HANDLE engineHandle,
[in] const FWPM_FILTER_SUBSCRIPTION0 *subscription,
[in] FWPM_FILTER_CHANGE_CALLBACK0 callback,
[in, optional] void *context,
[out] HANDLE *changeHandle
);
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] subscription
Tipo: FWPM_FILTER_SUBSCRIPTION0*
As notificações a serem entregues.
[in] callback
Tipo: FWPM_FILTER_CHANGE_CALLBACK0
O ponteiro de função que será invocado quando uma notificação estiver pronta para entrega.
[in, optional] context
Tipo: void*
Ponteiro de contexto opcional. Esse ponteiro é passado para a função de retorno de chamada junto com os detalhes da alteração.
[out] changeHandle
Tipo: HANDLE*
Manipule para a assinatura recém-criada.
Retornar valor
Tipo: DWORD
| Valor/código retornado | Descrição |
|---|---|
|
A assinatura foi criada 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
Os assinantes não recebem notificações de alterações feitas com o mesmo identificador de sessão usado para assinar. Isso ocorre porque os assinantes só precisam ver as alterações feitas por outras pessoas, pois já sabem quais alterações elas próprias fizeram.
Essa função não pode ser chamada de dentro de uma transação. Ele falhará com FWP_E_TXN_IN_PROGRESS. Consulte Gerenciamento de Objetos para obter mais informações sobre transações.
O chamador precisa FWPM_ACTRL_SUBSCRIBE acesso ao contêiner do filtro e FWPM_ACTRL_READ acesso ao filtro. O assinante só receberá notificações para filtros aos quais tem acesso FWPM_ACTRL_READ . Consulte Controle de Acesso para obter mais informações.
FwpmFilterSubscribeChanges0 é uma implementação específica de FwpmFilterSubscribeChanges. 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 |