FwpmLayerCreateEnumHandle0-Funktion (fwpmk.h)
Die FwpmLayerCreateEnumHandle0--Funktion erstellt ein Handle zum Aufzählen einer Reihe von Layerobjekten.
Syntax
NTSTATUS FwpmLayerCreateEnumHandle0(
[in] HANDLE engineHandle,
[in, optional] const FWPM_LAYER_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 die Layeraufzählung.
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 Ebenen zurückgegeben.
Der Enumerator ist nicht live, d. h., er spiegelt keine Änderungen wider, die nach dem Aufruf von FwpmLayerCreateEnumHandle0 vorgenommen wurden. Wenn Sie sicherstellen müssen, dass die Ergebnisse aktuell sind, müssen Sie FwpmLayerCreateEnumHandle0- und FwpmLayerEnum0- innerhalb derselben expliziten Transaktion aufrufen.
Der Aufrufer muss das zurückgegebene Handle durch einen Aufruf der FwpmLayerDestroyEnumHandle0freigeben.
Der Aufrufer benötigt FWPM_ACTRL_ENUM Zugriff auf die Container der Ebenen und FWPM_ACTRL_READ Zugriff auf die Ebenen. Es werden nur Ebenen zurückgegeben, auf die der Aufrufer FWPM_ACTRL_READ Zugriff hat. Weitere Informationen finden Sie unter Zugriffssteuerungs-.
FwpmLayerCreateEnumHandle0 ist eine spezifische Implementierung von FwpmLayerCreateEnumHandle. 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 |