FwpmNetEventSubscribe3-Funktion (fwpmu.h)

Artikel
05/03/2024

Wird verwendet, um die Zustellung von Benachrichtigungen zu einem bestimmten Netzereignis anzufordern.

Syntax

DWORD FwpmNetEventSubscribe3(
  HANDLE                             engineHandle,
  const FWPM_NET_EVENT_SUBSCRIPTION0 *subscription,
  FWPM_NET_EVENT_CALLBACK3           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_CALLBACK3, die aufgerufen wird, wenn eine Benachrichtigung zur Übermittlung bereit ist.

context

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

eventsHandle

Behandeln Sie das neu erstellte Abonnement. Rufen Sie fwpmNetEventUnsubscribe0 auf, um dieses Handle zu schließen, wenn das Abonnement nicht mehr benötigt wird.

Rückgabewert

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Das Abonnement wurde erfolgreich erstellt.
FWP_E_*-Fehlercode 0x80320001 – 0x80320039	Ein WFP-spezifischer Fehler (Windows Filtering Platform). Ausführliche Informationen finden Sie unter WFP-Fehlercodes.
RPC_*-Fehlercode 0x80010001 – 0x80010122	Fehler bei der Kommunikation mit der Remote- oder lokalen Firewall-Engine.

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.

Zum Aufrufen dieser Funktion benötigen Sie FWPM_ACTRL_SUBSCRIBE Zugriff auf den Container des Net-Ereignisses.

Anforderungen

Anforderung	Wert
Header	fwpmu.h
Bibliothek	fwpuclnt.lib
DLL	Fwpuclnt.dll

Freigeben über