FwpsAleEndpointEnum0, fonction (fwpsk.h)

Article
08/07/2023

La fonction FwpsAleEndpointEnum0 énumère les points de terminaison ale (Application Layer Enforcement).

RemarqueFwpsAleEndpointEnum0 est une version spécifique de FwpsAleEndpointEnum. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

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 pour 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

En retour, le nombre d’éléments dans le tableau de structures de propriétés de point de terminaison point de terminaison vers des entrées.

Valeur retournée

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

Code de retour	Description
STATUS_SUCCESS	La fonction a réussi.
Autres codes status	Une erreur est survenue.

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 enumTemplate facultatif 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.

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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 7.
Plateforme cible	Universal
En-tête	fwpsk.h (include Fwpsk.h)
Bibliothèque	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Voir aussi

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0

Partager via