FwpmProviderEnum0, fonction (fwpmk.h)

Article
07/16/2024

La fonction FwpmProviderEnum 0Enum0 retourne la page suivante des résultats de l’énumérateur de fournisseur.

Syntaxe

NTSTATUS FwpmProviderEnum0(
  [in]  HANDLE         engineHandle,
  [in]  HANDLE         enumHandle,
  [in]  UINT32         numEntriesRequested,
  [out] FWPM_PROVIDER0 ***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 fournisseur créée par un appel à FwpmProviderCreateEnumHandle0.

[in] numEntriesRequested

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

[out] entries

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

[out] numEntriesReturned

Nombre d’objets fournisseur retournés.

Valeur de retour

Retourner le code/la valeur	Description
ERROR_SUCCESS 0	Les fournisseurs ont été énumérés 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.

FwpmProviderEnum0 fonctionne sur un instantané des fournisseurs pris au moment de la création du handle d’énumération.

FwpmProviderEnum0 est une implémentation spécifique de FwpmProviderEnum. 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

Voici tous les liens mis en forme markdown dans le document actif :

Partager via