FwpmProviderContextEnum1, fonction (fwpmk.h)
La fonction FwpmProviderContextEnum1 retourne la page suivante des résultats de l’énumérateur de contexte du fournisseur.
Syntaxe
NTSTATUS FwpmProviderContextEnum1(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_PROVIDER_CONTEXT1 ***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 contexte de fournisseur créée par un appel à FwpmProviderContextCreateEnumHandle0.
[in] numEntriesRequested
Nombre d’objets de contexte de fournisseur demandés.
[out] entries
Objets de contexte de fournisseur retournés.
[out] numEntriesReturned
Nombre d’objets de contexte de fournisseur retournés.
Valeur de retour
| Retourner le code/la valeur | Description |
|---|---|
|
ERROR_SUCCESS 0 |
Les contextes du fournisseur 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 numEntriesReturned est inférieur à 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.
FwpmProviderContextEnum1 fonctionne sur un instantané des contextes du fournisseur pris au moment de la création du handle d’énumération.
FwpmProviderContextEnum1 est une implémentation spécifique de FwpmProviderContextEnum. 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 |