FwpsAleEndpointCreateEnumHandle0, fonction (fwpsk.h)

Article
02/07/2025

La fonction FwpsAleEndpointCreateEnumHandle0 crée un handle qui peut être utilisé avec d’autres fonctions de point de terminaison ale (Application Layer Enforcement) pour énumérer les données de point de terminaison.

RemarqueFwpsAleEndpointCreateEnumHandle0 est une version spécifique de FwpsAleEndpointCreateEnumHandle. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Syntaxe

NTSTATUS FwpsAleEndpointCreateEnumHandle0(
  [in]           HANDLE                                 engineHandle,
  [in, optional] const FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                                 *enumHandle
);

Paramètres

[in] engineHandle

Gérer une session ouverte avec le moteur de filtre. Ce handle est obtenu lorsqu’une session est ouverte en appelant FwpmEngineOpen0.

[in, optional] enumTemplate

Pointeur vers un FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 structure qui contient des paramètres pour affiner les résultats de l’énumération de point de terminaison.

[out] enumHandle

Handle d’énumération nouvellement créé.

Valeur de retour

La fonction FwpsAleEndpointCreateEnumHandle0 retourne l’un des codes NTSTATUS suivants.

Retourner le code	Description
STATUS_SUCCESS	La fonction a réussi.
Autres codes d’état	Une erreur s’est produite.

Remarques

Après avoir utilisé le handle acquis en appelant FwpsAleEndpointCreateEnumHandle0, le pilote de légende doit libérer les ressources système associées au handle en appelant FwpsAleEndpointDestroyEnumHandle0.

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

Voir aussi

FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointEnum0

Partager via