FwpsAleEndpointCreateEnumHandle0-Funktion (fwpsk.h)

Artikel
02/07/2025

Die FwpsAleEndpointCreateEnumHandle0-Funktion erstellt ein Handle, das mit anderen ALE-Endpunktfunktionen (Application Layer Enforcement) zum Aufzählen von Endpunktdaten verwendet werden kann.

HinweisFwpsAleEndpointCreateEnumHandle0 ist eine bestimmte Version von FwpsAleEndpointCreateEnumHandle. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und zielspezifische Versionen von Windows.

Syntax

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

Parameter

[in] engineHandle

Behandeln sie für eine geöffnete Sitzung mit dem Filtermodul. Dieses Handle wird abgerufen, wenn eine Sitzung durch Aufrufen FwpmEngineOpen0geöffnet wird.

[in, optional] enumTemplate

Ein Zeiger auf einen FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 Struktur, die Parameter enthält, um die Ergebnisse der Endpunktenumeration einzugrenzen.

[out] enumHandle

Das neu erstellte Enumerationshandle.

Rückgabewert

Die FwpsAleEndpointCreateEnumHandle0-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
Andere Statuscodes	Fehler.

Bemerkungen

Nachdem sie das durch Aufrufen von FwpsAleEndpointCreateEnumHandle0abgerufene Handle verwendet haben, muss der Popuptreiber die dem Handle zugeordneten Systemressourcen durch Aufrufen des Aufrufs freigeben. FwpsAleEndpointDestroyEnumHandle0.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 7.
Zielplattform-	Universal
Header-	fwpsk.h (include Fwpsk.h)
Library	Fwpkclnt.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointEnum0

Freigeben über