FwpmNetEventEnum1-Funktion (fwpmk.h)

  • Artikel

Die FwpmNetEventEnum1--Funktion gibt die nächste Ergebnisseite des Netzwerkereignis-Enumerations zurück.

Syntax

NTSTATUS FwpmNetEventEnum1(
  [in]  HANDLE          engineHandle,
  [in]  HANDLE          enumHandle,
  [in]  UINT32          numEntriesRequested,
  [out] FWPM_NET_EVENT1 ***entries,
  [out] UINT32          *numEntriesReturned
);

Parameter

[in] engineHandle

Behandeln einer geöffneten Sitzung für das Filtermodul. Rufen Sie FwpmEngineOpen0- auf, um eine Sitzung für das Filtermodul zu öffnen.

[in] enumHandle

Handle für eine Netzwerkereignisaufzählung, die durch einen Aufruf von FwpmNetEventCreateEnumHandle0erstellt wird.

[in] numEntriesRequested

Die Anzahl der angeforderten Enumerationseinträge.

[out] entries

Adressen von Enumerationseinträgen.

[out] numEntriesReturned

Die Anzahl der zurückgegebenen Enumerationseinträge.

Rückgabewert

Zurückgeben von Code/Wert Beschreibung
ERROR_SUCCESS
0		 Die Netzwerkereignisse wurden erfolgreich aufgezählt.
FWP_E_NET_EVENTS_DISABLED
0x80320013		 Die Sammlung von Netzwerkdiagnoseereignissen ist deaktiviert. Rufen Sie FwpmEngineSetOption0 auf, um sie zu aktivieren.
FWP_E_* Fehlercode
0x80320001 – 0x80320039		 Ein WFP-spezifischer Fehler (Windows-Filterplattform). Weitere Informationen finden Sie unter WFP-Fehlercodes.
RPC_*-Fehlercode
0x80010001 – 0x80010122		 Fehler bei der Kommunikation mit dem Remote- oder lokalen Firewallmodul.
Andere NTSTATUS-Codes Fehler.

Bemerkungen

Wenn die numEntriesReturned kleiner als die numEntriesRequestedist, wird die Enumeration erschöpft.

Das zurückgegebene Array von Einträgen (aber nicht die einzelnen Einträge selbst) muss durch einen Aufruf von FwpmFreeMemory0freigegeben werden.

Ein nachfolgender Aufruf, der denselben enumHandle Parameter verwendet, gibt den nächsten Satz von Ereignissen zurück, der den aktuellen Einträgen Puffer folgt.

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

FwpmNetEventEnum1 ist eine spezifische Implementierung von FwpmNetEventEnum. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und zielspezifische Versionen von Windows.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar ab Windows Vista.
Zielplattform- Universal
Header- fwpmk.h
Library fwpkclnt.lib
IRQL- <= PASSIVE_LEVEL

Siehe auch