FwpsAleEndpointEnum0-Funktion (fwpsk.h)

  • Artikel

Die Funktion FwpsAleEndpointEnum0 listet ALE-Endpunkte (Application Layer Enforcement) auf.

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

Syntax

NTSTATUS FwpsAleEndpointEnum0(
  [in]  HANDLE                        engineHandle,
  [in]  HANDLE                        enumHandle,
  [in]  UINT32                        numEntriesRequested,
  [out] FWPS_ALE_ENDPOINT_PROPERTIES0 ***entries,
  [out] UINT32                        *numEntriesReturned
);

Parameter

[in] engineHandle

Das 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] enumHandle

Das Enumerationshandle, das durch einen vorherigen Aufruf von FwpsAleEndpointDestroyEnumHandle0 erstellt wurde.

[in] numEntriesRequested

Die maximale Anzahl von Endpunkteigenschafteneinträgen, die zurückgegeben werden sollen. Die tatsächliche Anzahl der aufgelisteten Einträge wird in numEntriesReturned zurückgegeben. Die tatsächliche Zahl ist nur dann kleiner als die angeforderte Zahl, wenn weniger Endpunkte als die angeforderte vorhanden sind.

[out] entries

Ein Zeiger auf ein Array von FWPS_ALE_ENDPOINT_PROPERTIES0 Strukturzeigern. Jede Struktur enthält die Eigenschaften eines einzelnen Endpunkts. Das Array enthält so viele Elemente wie der wert, der in numEntriesReturned zurückgegeben wird.

[out] numEntriesReturned

Bei der Rückgabe die Anzahl der Elemente im Array der Endpunkteigenschaftenstrukturen, auf die von Einträgen verwiesen wird.

Rückgabewert

Die FwpsAleEndpointEnum0-Funktion 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

Um ALE-Endpunkte aufzulisten, muss der Legendentreiber zuerst ein Enumerationshandle abrufen, indem er FwpsAleEndpointCreateEnumHandle0 aufruft. Das zurückgegebene Handle ist allen Parametern zugeordnet, die im optionalen enumTemplate-Parameter von FwpsAleEndpointCreateEnumHandle0 angegeben sind.

Nach dem Abrufen eines Handles kann der Legendentreiber FwpsAleEndpointEnum0 aufrufen, um Informationen zu den Endpunkten abzurufen, die den Enumerationsparametern des Handles entsprechen.

Nach Abschluss der Überprüfung der Endpunkteigenschaften muss der Legendentreiber FwpsAleEndpointDestroyEnumHandle0 aufrufen, um die Systemressourcen freizugeben, die dem Enumerationshandle zugeordnet sind.

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

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0