FwpmProviderContextEnum3-Funktion (fwpmu.h)

Artikel
05/03/2024

Gibt die nächste Seite der Ergebnisse aus dem Anbieterkontext-Enumerator zurück.

Syntax

DWORD FwpmProviderContextEnum3(
  HANDLE                 engineHandle,
  HANDLE                 enumHandle,
  UINT32                 numEntriesRequested,
  FWPM_PROVIDER_CONTEXT3 ***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 FwpmProviderContextCreateEnumHandle0 erstellt wurde.

numEntriesRequested

Typ: _In_ UINT32

Anzahl der angeforderten Anbieterkontextobjekte.

entries

Typ: _Outptr_result_buffer_(*numEntriesReturned) FWPM_PROVIDER_CONTEXT3***

Die zurückgegebenen Anbieterkontextobjekte.

numEntriesReturned

Typ: _Out_ UINT32*

Die Anzahl der zurückgegebenen Anbieterkontextobjekte.

Rückgabewert

Typ: DWORD*

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Die Anbieterkontexte wurden erfolgreich aufgelistet.
FWP_E_*-Fehlercode 0x80320001 – 0x80320039	Ein WFP-spezifischer Fehler (Windows Filtering Platform). Weitere 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 auf die Ereignisse im letzten Ausgabepuffer folgen.

FwpmProviderContextEnum3 arbeitet an einer Momentaufnahme der Anbieterkontexte, die zum Zeitpunkt der Erstellung des Enumerationshandles verwendet wurden.

Anforderungen

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

Freigeben über