FwpmProviderEnum0-Funktion (fwpmk.h)

Artikel
07/16/2024

Die FwpmProviderEnum0--Funktion gibt die nächste Seite mit Ergebnissen des Anbieterenumerators zurück.

Syntax

NTSTATUS FwpmProviderEnum0(
  [in]  HANDLE         engineHandle,
  [in]  HANDLE         enumHandle,
  [in]  UINT32         numEntriesRequested,
  [out] FWPM_PROVIDER0 ***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 Anbieteraufzählung, die durch einen Aufruf von FwpmProviderCreateEnumHandle0erstellt wird.

[in] numEntriesRequested

Die Anzahl der angeforderten Anbietereinträge.

[out] entries

Adressen der Enumerationseinträge.

[out] numEntriesReturned

Die Anzahl der zurückgegebenen Anbieterobjekte.

Rückgabewert

Zurückgeben von Code/Wert	Beschreibung
ERROR_SUCCESS 0	Die Anbieter wurden erfolgreich aufgezählt.
*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 mit demselben Enumerationshandle gibt den nächsten Satz von Elementen zurück, die den letzten Ausgabepuffern folgen.

FwpmProviderEnum0 arbeitet an einer Momentaufnahme der Anbieter, die zum Zeitpunkt der Erstellung des Enumerationshandles erstellt wurden.

FwpmProviderEnum0 ist eine spezifische Implementierung von FwpmProviderEnum. 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

Hier sind alle markdown formatierten Links im aktuellen Dokument:

Freigeben über