Compartilhar via


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
ERROR_SUCCESS
0
A assinatura foi criada com êxito.
código de erro FWP_E_*
0x80320001 — 0x80320039
Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte Códigos de erro WFP para obter detalhes.
código de erro RPC_*
0x80010001 — 0x80010122
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

Confira também

FWPM_FILTER_CHANGE_CALLBACK0

FWPM_FILTER_SUBSCRIPTION0

FwpmFilterUnsubscribeChanges0