FwpmLayerEnum0-Funktion (fwpmk.h)
Die FwpmLayerEnum0-Funktion gibt die nächste Seite mit Ergebnissen aus dem Layer-Enumerator zurück.
Syntax
NTSTATUS FwpmLayerEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_LAYER0 ***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 Layeraufzählung, die durch einen Aufruf von FwpmLayerCreateEnumHandle0erstellt wird.
[in] numEntriesRequested
Die Anzahl der angeforderten Layereinträge.
[out] entries
Adressen der Enumerationseinträge.
[out] numEntriesReturned
Die Anzahl der zurückgegebenen Layereinträge.
Rückgabewert
| Zurückgeben von Code/Wert | Beschreibung |
|---|---|
|
ERROR_SUCCESS 0 |
Die Ebenen 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.
FwpmLayerEnum0 ist eine spezifische Implementierung von FwpmLayerEnum. 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 |