FwpsAleEndpointEnum0-Funktion (fwpsk.h)

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

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.

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

Weitere Informationen

FwpsAleEndpointGetById0