FwpsAleEndpointCreateEnumHandle0-Funktion (fwpsk.h)

Artikel
02/29/2024

Die FwpsAleEndpointCreateEnumHandle0-Funktion erstellt ein Handle, das mit anderen ALE-Endpunktfunktionen (Application Layer Enforcement) verwendet werden kann, um Endpunktdaten aufzulisten.

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

Syntax

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

Parameter

[in] engineHandle

Handle für eine geöffnete Sitzung mit der Filter-Engine. Dieses Handle wird abgerufen, wenn eine Sitzung durch Aufrufen von FwpmEngineOpen0 geöffnet wird.

[in, optional] enumTemplate

Ein Zeiger auf einen FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 Struktur, die Parameter enthält, um die Endpunktaufzählungsergebnisse einzugrenzen.

[out] enumHandle

Das neu erstellte Enumerationshandle.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Nach der Verwendung des Handle, das durch Aufrufen von FwpsAleEndpointCreateEnumHandle0 abgerufen wurde, muss der Legendentreiber die systemressourcen freigeben, die dem Handle zugeordnet sind, indem er aufruft. FwpsAleEndpointDestroyEnumHandle0.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 7.
Zielplattform	Universell
Header	fwpsk.h (include fwpsk.h)
Bibliothek	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointEnum0

Freigeben über