FwpmSessionEnum0, fonction (fwpmu.h)

Article
03/02/2024

La fonction FwpmSessionEnum0 retourne la page suivante des résultats de l’énumérateur de session.

Syntaxe

DWORD FwpmSessionEnum0(
  [in]  HANDLE        engineHandle,
  [in]  HANDLE        enumHandle,
  [in]  UINT32        numEntriesRequested,
  [out] FWPM_SESSION0 ***entries,
  [out] UINT32        *numEntriesReturned
);

Paramètres

[in] engineHandle

Type : HANDLE

Handle pour une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.

[in] enumHandle

Type : HANDLE

Handle pour une énumération de session créée par un appel à FwpmSessionCreateEnumHandle0.

[in] numEntriesRequested

Type : UINT32

Nombre d’entrées de session demandées.

[out] entries

Type : FWPM_SESSION0***

Adresses des entrées d’énumération.

[out] numEntriesReturned

Type : UINT32*

Nombre d’objets de session retournés.

Valeur retournée

Type : DWORD

Code/valeur de retour	Description
ERROR_SUCCESS 0	Les sessions ont été énumérées avec succès.
code d’erreur FWP_E_* 0x80320001—0x80320039	Une erreur spécifique à la plateforme de filtrage Windows (PAM). Pour plus d’informations, consultez Codes d’erreur PAM .
code d’erreur RPC_* 0x80010001—0x80010122	Échec de la communication avec le moteur de pare-feu distant ou local.

Remarques

Si numEntriesReturned est inférieur à numEntriesRequested, l’énumération est épuisée.

Le tableau d’entrées retourné (mais pas les entrées individuelles elles-mêmes) doit être libéré par un appel à FwpmFreeMemory0.

Un appel suivant utilisant le même handle d’énumération retourne le jeu d’éléments suivant ceux du dernier tampon de sortie.

FwpmSessionEnum0 fonctionne sur un instantané des sessions prises au moment de la création du handle d’énumération.

FwpmSessionEnum0 est une implémentation spécifique de FwpmSessionEnum. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	fwpmu.h
Bibliothèque	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Voir aussi

FWPM_SESSION0

FwpmSessionCreateEnumHandle0

Partager via