Função FwpmSubLayerSubscribeChanges0 (fwpmu.h)

  • Artigo

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

Sintaxe

DWORD FwpmSubLayerSubscribeChanges0(
  [in]           HANDLE                            engineHandle,
  [in]           const FWPM_SUBLAYER_SUBSCRIPTION0 *subscription,
  [in]           FWPM_SUBLAYER_CHANGE_CALLBACK0    callback,
  [in, optional] void                              *context,
  [out]          HANDLE                            *changeHandle
);

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] subscription

Tipo: FWPM_SUBLAYER_SUBSCRIPTION0*

As notificações a serem entregues.

[in] callback

Tipo: FWPM_SUBLAYER_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.

Valor retornado

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 do 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 subcaminho e FWPM_ACTRL_READ acesso à subcaminha. O assinante só receberá notificações para subcaminhos aos quais tem acesso FWPM_ACTRL_READ . Consulte Controle de Acesso para obter mais informações.

FwpmSubLayerSubscribeChanges0 é uma implementação específica de FwpmSubLayerSubscribeChanges. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.

Requisitos

   
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_SUBLAYER_CHANGE_CALLBACK0

FWPM_SUBLAYER_SUBSCRIPTION0