Freigeben über

FwpmProviderContextCreateEnumHandle0-Funktion (fwpmk.h)

  • Artikel

Die FwpmProviderContextCreateEnumHandle0--Funktion erstellt ein Handle zum Aufzählen einer Reihe von Anbieterkontexten.

Syntax

NTSTATUS FwpmProviderContextCreateEnumHandle0(
  [in]           HANDLE                                     engineHandle,
  [in, optional] const FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                                     *enumHandle
);

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, optional] enumTemplate

Vorlage, um die Enumeration selektiv einzuschränken.

[out] enumHandle

Handle für Anbieterkontextenumeration.

Rückgabewert

Zurückgeben von Code/Wert Beschreibung
ERROR_SUCCESS
0		 Der Enumerator wurde erfolgreich erstellt.
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 enumerationTemplate-NULL-ist, werden alle Anbieterkontexte zurückgegeben.

Der Enumerator ist nicht live, d. h. es spiegelt keine Änderungen wider, die nach dem Aufruf von FwpmProviderContextCreateEnumHandle0 vorgenommen wurden. Wenn Sie sicherstellen müssen, dass die Ergebnisse aktuell sind, müssen Sie FwpmProviderContextCreateEnumHandle0 aufrufen und FwpmProviderContextEnum0 innerhalb derselben expliziten Transaktion aufrufen.

Der Aufrufer muss das zurückgegebene Handle durch einen Aufruf von FwpmProviderContextDestroyEnumHandle0freigeben.

Der Aufrufer benötigt FWPM_ACTRL_ENUM Zugriff auf die Container des Anbieterkontexts und FWPM_ACTRL_READ Zugriff auf die Anbieterkontexte. Es werden nur Anbieterkontexte zurückgegeben, für die der Aufrufer über FWPM_ACTRL_READ Zugriff verfügt. Weitere Informationen finden Sie unter Zugriffssteuerungs-.

FwpmProviderContextCreateEnumHandle0 ist eine spezifische Implementierung von FwpmProviderContextCreateEnumHandle. 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