Partager via

FwpmCalloutEnum0, fonction (fwpmk.h)

  • Article

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

Syntaxe

NTSTATUS FwpmCalloutEnum0(
  [in]  HANDLE        engineHandle,
  [in]  HANDLE        enumHandle,
  [in]  UINT32        numEntriesRequested,
  [out] FWPM_CALLOUT0 ***entries,
  [out] UINT32        *numEntriesReturned
);

Paramètres

[in] engineHandle

Gérer une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session au moteur de filtre.

[in] enumHandle

Handle pour une énumération de légende créée par un appel à FwpmCalloutCreateEnumHandle0.

[in] numEntriesRequested

Nombre d’objets de légende demandés.

[out] entries

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

[out] numEntriesReturned

Nombre de légendes retournées.

Valeur de retour

Retourner le code/la valeur Description
ERROR_SUCCESS
0		 Les légendes ont été énumérées avec succès.
code d’erreur FWP_E_*
0x80320001 — 0x80320039		 Erreur spécifique à la plateforme de filtrage Windows (PAM). Consultez codes d’erreur PAM pour plus d’informations.
code d’erreur RPC_*
0x80010001 — 0x80010122		 Échec de la communication avec le moteur de pare-feu distant ou local.
autres codes NTSTATUS Une erreur s’est produite.

Remarques

Si la numEntriesReturned est inférieure à la 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 de la dernière mémoire 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 PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows Vista.
plateforme cible Universel
d’en-tête fwpmk.h
bibliothèque fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Voir aussi