Fonction FwpmProviderContextCreateEnumHandle0 (fwpmu.h)
La fonction FwpmProviderContextCreateEnumHandle0 crée un handle utilisé pour énumérer un ensemble de contextes de fournisseur.
Syntaxe
DWORD FwpmProviderContextCreateEnumHandle0(
[in] HANDLE engineHandle,
[in, optional] const FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0 *enumTemplate,
[out] HANDLE *enumHandle
);
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, optional] enumTemplate
Type : const FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0*
Modèle pour restreindre sélectivement l’énumération.
[out] enumHandle
Type : HANDLE*
Handle pour l’énumération du contexte du fournisseur.
Valeur retournée
Type : DWORD
Code/valeur de retour | Description |
---|---|
|
L’énumérateur a été créé 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. |
Remarques
Si enumTemplate a la valeur NULL, tous les contextes de fournisseur sont retournés.
L’énumérateur n’est pas « actif », ce qui signifie qu’il ne reflète pas les modifications apportées au système après l’appel à FwpmProviderContextCreateEnumHandle0 retourné. Si vous devez vous assurer que les résultats sont à jour, vous devez appeler FwpmProviderContextCreateEnumHandle0 et FwpmProviderContextEnum0 à partir de la même transaction explicite.
L’appelant doit libérer le handle retourné par un appel à FwpmProviderContextDestroyEnumHandle0.
L’appelant a besoin d’un accès FWPM_ACTRL_ENUM aux conteneurs des contextes du fournisseur et d’un accès FWPM_ACTRL_READ aux contextes du fournisseur. Seuls les contextes de fournisseur auxquels l’appelant a FWPM_ACTRL_READ accès sont retournés. Pour plus d’informations, consultez Access Control.
FwpmProviderContextCreateEnumHandle0 est une implémentation spécifique de FwpmProviderContextCreateEnumHandle. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .
Configuration requise
Condition requise | Valeur |
---|---|
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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour