Compartilhar via

Função FwpmNetEventSubscribe4 (fwpmu.h)

  • Artigo

Usado para solicitar a entrega de notificações sobre um evento net específico.

Sintaxe

DWORD FwpmNetEventSubscribe4(
  HANDLE                             engineHandle,
  const FWPM_NET_EVENT_SUBSCRIPTION0 *subscription,
  FWPM_NET_EVENT_CALLBACK4           callback,
  void                               *context,
  HANDLE                             *eventsHandle
);

Parâmetros

engineHandle

Tipo: _In_ HANDLE

Um identificador para uma sessão aberta com o mecanismo de filtro. Para abrir uma sessão com o mecanismo de filtro, chame FwpmEngineOpen0.

subscription

Uma estrutura FWPM_NET_EVENT_SUBSCRIPTION0 que descreve quais notificações serão entregues.

callback

Ponteiro para uma função do tipo FWPM_NET_EVENT_CALLBACK4, que será invocada quando uma notificação estiver pronta para entrega.

context

Ponteiro de contexto opcional. Esse ponteiro é passado para a função de retorno de chamada junto com os detalhes do evento.

eventsHandle

Manipule para a assinatura recém-criada. Chame FwpmNetEventUnsubscribe0 para fechar esse identificador quando a assinatura não for mais necessária.

Retornar valor

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). Para obter detalhes, consulte Códigos de erro do WFP.
código de erro RPC_*
0x80010001 — 0x80010122		 Falha ao se comunicar com o mecanismo de firewall remoto ou local.

Comentários

Você não pode chamar essa função em uma transação. Ele falhará com FWP_E_TXN_IN_PROGRESS. Para obter mais informações sobre transações, consulte Gerenciamento de objetos.

Para chamar essa função, você precisa FWPM_ACTRL_SUBSCRIBE acesso ao contêiner do evento net.

Requisitos

Requisito Valor
Cabeçalho fwpmu.h
Biblioteca Fwpuclnt.lib
DLL Fwpuclnt.dll