Fonction FwpmConnectionEnum0 (fwpmu.h)
La fonction FwpmConnectionEnum0 retourne la page suivante des résultats de l’énumérateur d’objet de connexion.
Syntaxe
DWORD FwpmConnectionEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_CONNECTION0 ***entries,
[out] UINT32 *numEntriesReturned
);
Paramètres
[in] engineHandle
Type : HANDLE
Gérer 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 contexte de fournisseur créée par un appel à FwpmConnectionCreateEnumHandle0.
[in] numEntriesRequested
Type : UINT32
Nombre d’objets de connexion demandés.
[out] entries
Type : FWPM_CONNECTION0***
Adresses des entrées d’énumération.
[out] numEntriesReturned
Type : UINT32*
Valeur retournée
Type : DWORD
| Code/valeur de retour | Description |
|---|---|
|
Les objets de connexion ont été énumérés avec succès. |
|
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. |
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 l’ensemble d’éléments suivant ceux du dernier tampon de sortie.
FwpmConnectionEnum0 fonctionne sur un instantané des objets de connexion pris au moment de la création du handle d’énumération.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | fwpmu.h |
| Bibliothèque | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |