FwpsAleEndpointEnum0, fonction (fwpsk.h)
La fonction FwpsAleEndpointEnum0 énumère les points de terminaison ale (Application Layer Enforcement).
Syntaxe
NTSTATUS FwpsAleEndpointEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPS_ALE_ENDPOINT_PROPERTIES0 ***entries,
[out] UINT32 *numEntriesReturned
);
Paramètres
[in] engineHandle
Handle d’une session ouverte avec le moteur de filtre. Ce handle est obtenu lorsqu’une session est ouverte en appelant FwpmEngineOpen0.
[in] enumHandle
Handle d’énumération créé par un appel précédent à FwpsAleEndpointDestroyEnumHandle0.
[in] numEntriesRequested
Nombre maximal d’entrées de propriété de point de terminaison à retourner. Le nombre réel d’entrées énumérées est retourné dans numEntriesReturned. Le nombre réel est inférieur au nombre demandé uniquement si moins de points de terminaison que ceux demandés sont présents.
[out] entries
Pointeur vers un tableau de pointeurs de structure FWPS_ALE_ENDPOINT_PROPERTIES0. Chaque structure contient les propriétés d’un point de terminaison unique. Le tableau contient autant d’éléments que la valeur retournée dans numEntriesReturned.
[out] numEntriesReturned
Lors du retour, le nombre d’éléments dans le tableau de structures de propriétés de point de terminaison point de terminaison point de terminaison par entrées.
Valeur de retour
La fonction FwpsAleEndpointEnum0 retourne l’un des codes NTSTATUS suivants.
| Retourner le code | Description |
|---|---|
|
La fonction a réussi. |
|
Une erreur s’est produite. |
Remarques
Pour énumérer les points de terminaison ALE, le pilote de légende doit d’abord obtenir un handle d’énumération en appelant FwpsAleEndpointCreateEnumHandle0. Le handle retourné est associé à tous les paramètres spécifiés dans le paramètre facultatif enumTemplate de FwpsAleEndpointCreateEnumHandle0.
Après avoir obtenu un handle, le pilote de légende peut appeler FwpsAleEndpointEnum0 pour obtenir des informations sur les points de terminaison qui correspondent aux paramètres d’énumération du handle.
Notez que le champ localV4Address de l’FWPS_ALE_ENDPOINT_PROPERTIES0 retourné est dans l’ordre d’octet hôte, tandis que localV6Address est dans l’ordre d’octets réseau. Pour utiliser l’adresse IPv4 à partir du champ localV4Address, vous devez appeler htonl() sur localV4Address pour le stocker dans une structure in_addr et vérifier que le sockaddr est correctement mis en forme.
Lorsque vous avez terminé d’examiner les propriétés du point de terminaison, le pilote de légende doit appeler FwpsAleEndpointDestroyEnumHandle0 pour libérer les ressources système associées au handle d’énumération.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 7. |
| plateforme cible | Universel |
| d’en-tête | fwpsk.h (include Fwpsk.h) |
| bibliothèque | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |