FwpmProviderContextEnum1-Funktion (fwpmk.h)

  • Artikel

Die FwpmProviderContextEnum1--Funktion gibt die nächste Seite mit Ergebnissen aus dem Anbieterkontext-Enumerator zurück.

Syntax

NTSTATUS FwpmProviderContextEnum1(
  [in]  HANDLE                 engineHandle,
  [in]  HANDLE                 enumHandle,
  [in]  UINT32                 numEntriesRequested,
  [out] FWPM_PROVIDER_CONTEXT1 ***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 Anbieterkontextaufzählung, die durch einen Aufruf von FwpmProviderContextCreateEnumHandle0erstellt wird.

[in] numEntriesRequested

Die Anzahl der angeforderten Anbieterkontextobjekte.

[out] entries

Die zurückgegebenen Anbieterkontextobjekte.

[out] numEntriesReturned

Die Anzahl der zurückgegebenen Anbieterkontextobjekte.

Rückgabewert

Zurückgeben von Code/Wert Beschreibung
ERROR_SUCCESS
0		 Die Anbieterkontexte 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 "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.

FwpmProviderContextEnum1 arbeitet an einer Momentaufnahme der Anbieterkontexte, die zum Zeitpunkt der Erstellung des Enumerationshandles erstellt wurden.

FwpmProviderContextEnum1 ist eine spezifische Implementierung von FwpmProviderContextEnum. 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