FwpmNetEventSubscribe4-Funktion (fwpmu.h)

Wird verwendet, um die Zustellung von Benachrichtigungen zu einem bestimmten Net-Ereignis anzufordern.

Syntax

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

Parameter

engineHandle

Typ: _In_ HANDLE

Ein Handle für eine geöffnete Sitzung mit der Filter-Engine. Um eine Sitzung mit der Filter-Engine zu öffnen, rufen Sie FwpmEngineOpen0 auf.

subscription

Eine FWPM_NET_EVENT_SUBSCRIPTION0 Struktur, die beschreibt, welche Benachrichtigungen übermittelt werden.

callback

Zeiger auf eine Funktion vom Typ FWPM_NET_EVENT_CALLBACK4, die aufgerufen wird, wenn eine Benachrichtigung bereit für die Übermittlung ist.

context

Optionaler Kontextzeiger. Dieser Zeiger wird zusammen mit Details des Ereignisses an die Rückruffunktion übergeben.

eventsHandle

Handle für das neu erstellte Abonnement. Rufen Sie FwpmNetEventUnsubscribe0 auf, um dieses Handle zu schließen, wenn das Abonnement nicht mehr benötigt wird.

Rückgabewert

Hinweise

Sie können diese Funktion nicht innerhalb einer Transaktion aufrufen. Bei FWP_E_TXN_IN_PROGRESS tritt ein Fehler auf. Weitere Informationen zu Transaktionen finden Sie unter Objektverwaltung.

Um diese Funktion aufzurufen, benötigen Sie FWPM_ACTRL_SUBSCRIBE Zugriff auf den Container des net-Ereignisses.

Anforderungen