FwpsAleEndpointEnum0-Funktion (fwpsk.h)
Die FwpsAleEndpointEnum0-Funktion listet Anwendungsschichterzwingungsendpunkte (Application Layer Enforcement, ALE) 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 dem Filtermodul. Dieses Handle wird abgerufen, wenn eine Sitzung durch Aufrufen FwpmEngineOpen0geöffnet wird.
[in] enumHandle
Das von einem vorherigen Aufruf von FwpsAleEndpointDestroyEnumHandle0erstellte Enumerationshandle0 .
[in] numEntriesRequested
Die maximale Anzahl der zurückzugebenden Endpunkteigenschafteneinträge. Die tatsächliche Anzahl der aufgezählten Einträge wird in numEntriesReturnedzurückgegeben. Die tatsächliche Zahl ist kleiner als die angeforderte Zahl, wenn weniger Endpunkte als die angeforderte Zahl 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 in numEntriesReturnedzurückgegebene Wert.
[out] numEntriesReturned
Die Anzahl der Elemente im Array der Endpunkteigenschaftsstrukturen, auf die durch Einträgeverwiesen wird, wird zurückgegeben.
Rückgabewert
Die funktion FwpsAleEndpointEnum0 gibt einen der folgenden NTSTATUS-Codes zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion war erfolgreich. |
|
Fehler. |
Bemerkungen
Zum Aufzählen von ALE-Endpunkten muss der Popuptreiber zuerst ein Enumerationshandle abrufen, indem FwpsAleEndpointCreateEnumHandle0aufgerufen wird. Das zurückgegebene Handle ist allen Parametern zugeordnet, die in der optionalen enumTemplate Parameter von FwpsAleEndpointCreateEnumHandle0angegeben sind.
Nach dem Abrufen eines Handles kann der Popuptreiber FwpsAleEndpointEnum0- aufrufen, um Informationen zu den Endpunkten abzurufen, die den Enumerationsparametern des Handles entsprechen.
Beachten Sie, dass sich das localV4Address-Feld aus dem zurückgegebenen FWPS_ALE_ENDPOINT_PROPERTIES0 in host-byte-Reihenfolge befindet, während sich die localV6Address in der Netzwerk-Byte-Reihenfolge befindet. Um die IPv4-Adresse aus dem localV4Address-Feld zu verwenden, müssen Sie "htonl()" auf der localV4Address aufrufen, um sie in einer in_addr Struktur zu speichern und sicherzustellen, dass der Sockaddr ordnungsgemäß formatiert ist.
Nach Abschluss der Untersuchung von Endpunkteigenschaften muss der Popuptreiber FwpsAleEntroyEntroyEnumHandle0- aufrufen, um die systemressourcen freizugeben, die dem Enumerationshandle zugeordnet sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 7. |
| Zielplattform- | Universal |
| Header- | fwpsk.h (include Fwpsk.h) |
| Library | Fwpkclnt.lib |
| IRQL- | PASSIVE_LEVEL |