Fonction FwpmCalloutEnum0 (fwpmu.h)
La fonction FwpmCalloutEnum0 retourne la page suivante des résultats de l’énumérateur de légende.
Syntaxe
DWORD FwpmCalloutEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_CALLOUT0 ***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 légende créée par un appel à FwpmCalloutCreateEnumHandle0.
[in] numEntriesRequested
Type : UINT32
Nombre d’objets de légende demandés.
[out] entries
Type : FWP_CALLOUT0***
Adresses des entrées d’énumération.
[out] numEntriesReturned
Type : UINT32*
Nombre de légendes retournées.
Valeur retournée
Type : DWORD
| Code/valeur de retour | Description |
|---|---|
|
Les légendes ont été énumérées avec succès. |
|
Une erreur spécifique à la plateforme de filtrage Windows (PAM). Pour plus d’informations, consultez Codes d’erreur PAM . |
|
Échec de la communication avec le moteur de pare-feu distant ou local. |
Notes
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.
FwpmCalloutEnum0 fonctionne sur un instantané des légendes prises au moment de la création du handle d’énumération.
FwpmCalloutEnum0 est une implémentation spécifique de FwpmCalloutEnum. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .
Spécifications
| 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 |