Funzione FwpsAleEndpointEnum0 (fwpsk.h)
La funzione FwpsAleEndpointEnum0 enumera gli endpoint di applicazione di imposizione del livello applicazione.The FwpsAleEndpointEnum0 function enumerates application layer enforcement (ALE).
Sintassi
NTSTATUS FwpsAleEndpointEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPS_ALE_ENDPOINT_PROPERTIES0 ***entries,
[out] UINT32 *numEntriesReturned
);
Parametri
[in] engineHandle
Handle per una sessione aperta con il motore di filtro. Questo handle viene ottenuto quando una sessione viene aperta chiamando FwpmEngineOpen0.
[in] enumHandle
Handle di enumerazione creato da una chiamata precedente a FwpsAleEndpointDestroyEnumHandle0.
[in] numEntriesRequested
Numero massimo di voci di proprietà dell'endpoint da restituire. Il numero effettivo di voci enumerate viene restituito in numEntriesReturned. Il numero effettivo è minore del numero richiesto solo se sono presenti meno endpoint rispetto a quelli richiesti.
[out] entries
Puntatore a una matrice di puntatori di struttura FWPS_ALE_ENDPOINT_PROPERTIES0. Ogni struttura contiene le proprietà di un singolo endpoint. La matrice contiene tutti gli elementi restituiti nel valore restituito in numEntriesReturned.
[out] numEntriesReturned
In caso di restituzione, il numero di elementi nella matrice di strutture delle proprietà dell'endpoint a cui punta voci.
Valore restituito
La funzione FwpsAleEndpointEnum0 restituisce uno dei codici NTSTATUS seguenti.
| Codice restituito | Descrizione |
|---|---|
|
La funzione ha avuto esito positivo. |
|
Si è verificato un errore. |
Osservazioni
Per enumerare gli endpoint ALE, il driver callout deve prima ottenere un handle di enumerazione chiamando FwpsAleEndpointCreateEnumHandle0. L'handle restituito è associato a qualsiasi parametro specificato nel parametro facoltativo enumTemplate di FwpsAleEndpointCreateEnumHandle0.
Dopo aver ottenuto un handle, il driver callout può chiamare FwpsAleEndpointEnum0 per ottenere informazioni sugli endpoint che corrispondono ai parametri di enumerazione dell'handle.
Si noti che il campo localV4Address del FWPS_ALE_ENDPOINT_PROPERTIES0 restituito è in ordine di byte host, mentre localV6Address è in ordine di byte di rete. Per usare l'indirizzo IPv4 dal campo localV4Address, è necessario chiamare htonl() nell'indirizzo localV4Address per archiviarlo in una struttura in_addr e assicurarsi che il sockaddr sia formattato correttamente.
Al termine dell'analisi delle proprietà dell'endpoint, il driver callout deve chiamare FwpsAleEndpointDestroyEnumHandle0 per rilasciare le risorse di sistema associate all'handle di enumerazione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 7. |
| piattaforma di destinazione | Universale |
| intestazione | fwpsk.h (include Fwpsk.h) |
| libreria | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |