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.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion wurde erfolgreich ausgeführt. |
|
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 |