FwpsAleEndpointCreateEnumHandle0-Funktion (fwpsk.h)

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