Função FwpmCalloutSubscribeChanges0 (fwpmu.h)

  • Artigo

A função FwpmCalloutSubscribeChanges0 é usada para solicitar a entrega de notificações sobre alterações em um texto explicativo específico.

Sintaxe

DWORD FwpmCalloutSubscribeChanges0(
  [in]           HANDLE                           engineHandle,
  [in]           const FWPM_CALLOUT_SUBSCRIPTION0 *subscription,
  [in]           FWPM_CALLOUT_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_CALLOUT_SUBSCRIPTION0*

As notificações que serão entregues.

[in] callback

Tipo: FWPM_CALLOUT_CHANGE_CALLBACK0

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 texto explicativo e FWPM_ACTRL_READ acesso ao texto explicativo. O assinante só receberá notificações para textos explicativos aos quais tem acesso FWPM_ACTRL_READ . Consulte Controle de Acesso para obter mais informações.

FwpmCalloutSubscribeChanges0 é uma implementação específica de FwpmCalloutSubscribeChanges. 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_CALLOUT_CHANGE_CALLBACK0

FWPM_CALLOUT_SUBSCRIPTION0

FwpmCalloutUnsubscribeChanges0