Funzione FwpmNetEventSubscribe3 (fwpmu.h)

Usato per richiedere il recapito delle notifiche relative a un determinato evento net.

Sintassi

DWORD FwpmNetEventSubscribe3(
  HANDLE                             engineHandle,
  const FWPM_NET_EVENT_SUBSCRIPTION0 *subscription,
  FWPM_NET_EVENT_CALLBACK3           callback,
  void                               *context,
  HANDLE                             *eventsHandle
);

Parametri

engineHandle

Tipo: _In_ HANDLE

Handle per una sessione aperta con il motore di filtro. Per aprire una sessione con il motore di filtro, chiamare FwpmEngineOpen0.

subscription

Struttura FWPM_NET_EVENT_SUBSCRIPTION0 che descrive quali notifiche verranno recapitate.

callback

Puntatore a una funzione di tipo FWPM_NET_EVENT_CALLBACK3, che verrà richiamato quando una notifica è pronta per il recapito.

context

Puntatore di contesto facoltativo. Questo puntatore viene passato alla funzione di callback insieme ai dettagli dell'evento.

eventsHandle

Gestire la sottoscrizione appena creata. Chiamare FwpmNetEventUnsubscribe0 per chiudere questo handle quando la sottoscrizione non è più necessaria.

Valore restituito

Commenti

Non è possibile chiamare questa funzione all'interno di una transazione. Avrà esito negativo con FWP_E_TXN_IN_PROGRESS. Per altre informazioni sulle transazioni, vedi Gestione degli oggetti.

Per chiamare questa funzione, è necessario FWPM_ACTRL_SUBSCRIBE l'accesso al contenitore dell'evento net.

Requisiti