FwpmNetEventEnum5-Funktion (fwpmu.h)

Artikel
05/03/2024

Ruft die nächste Seite der Ergebnisse aus dem Netzwerkereignis-Enumerator ab.

Syntax

DWORD FwpmNetEventEnum5(
  HANDLE          engineHandle,
  HANDLE          enumHandle,
  UINT32          numEntriesRequested,
  FWPM_NET_EVENT5 ***entries,
  UINT32          *numEntriesReturned
);

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.

enumHandle

Typ: _In_ HANDLE

Ein Handle für eine Netzwerkereignisaufzählung, die durch einen Aufruf von FwpmNetEventCreateEnumHandle0 erstellt wurde.

numEntriesRequested

Typ: _In_ UINT32

Die Anzahl der angeforderten Enumerationseinträge.

entries

Typ: _Outptr_result_buffer_(*numEntriesReturned) const FWPM_NET_EVENT5***

Adressen von Enumerationseinträgen.

numEntriesReturned

Typ: _Out_ UINT32*

Die Anzahl der zurückgegebenen Enumerationseinträge.

Rückgabewert

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Die Netzwerkereignisse wurden erfolgreich aufgelistet.
FWP_E_NET_EVENTS_DISABLED 0x80320013	Die Sammlung von Netzwerkdiagnoseereignissen ist deaktiviert.
Rufen Sie FwpmEngineSetOption0 auf, um es zu aktivieren.
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

Wenn numEntriesReturned kleiner als numEntriesRequested ist, ist die Enumeration erschöpft.

Sie müssen das zurückgegebene Array von Einträgen (aber nicht die einzelnen Einträge selbst) freigeben, indem Sie FwpmFreeMemory0 aufrufen.

Ein nachfolgender Aufruf, der denselben enumHandle-Parameter verwendet, gibt den nächsten Satz von Ereignissen zurück, die den Ereignissen im aktuellen Einträgepuffer folgen.

FwpmNetEventEnum5 gibt nur Ereignisse zurück, die vor der Erstellung des enumHandle-Parameters protokolliert wurden. Weitere Informationen finden Sie unter Protokollierung.

Anforderungen

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

Freigeben über