Función FwpmNetEventSubscribe4 (fwpmu.h)

Se usa para solicitar la entrega de notificaciones con respecto a un evento net determinado.

Sintaxis

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

Identificador de una sesión abierta con el motor de filtros. Para abrir una sesión con el motor de filtro, llame a FwpmEngineOpen0.

subscription

Estructura FWPM_NET_EVENT_SUBSCRIPTION0 que describe qué notificaciones se entregarán.

callback

Puntero a una función de tipo FWPM_NET_EVENT_CALLBACK4, que se invocará cuando una notificación esté lista para la entrega.

context

Puntero de contexto opcional. Este puntero se pasa a la función de devolución de llamada junto con los detalles del evento.

eventsHandle

Controle la suscripción recién creada. Llame a FwpmNetEventUnsubscribe0 para cerrar este identificador cuando la suscripción ya no sea necesaria.

Valor devuelto

Comentarios

No se puede llamar a esta función dentro de una transacción. Se producirá un error con FWP_E_TXN_IN_PROGRESS. Para obtener más información sobre las transacciones, consulte Administración de objetos.

Para llamar a esta función, necesita FWPM_ACTRL_SUBSCRIBE acceso al contenedor del evento net.

Requisitos