Fonction IPsecSaContextCreateEnumHandle0 (fwpmu.h)
La fonction IPsecSaContextCreateEnumHandle0 crée un handle utilisé pour énumérer un ensemble d’objets de contexte d’association de sécurité (SA) IPsec.
Syntaxe
DWORD IPsecSaContextCreateEnumHandle0(
[in] HANDLE engineHandle,
[in, optional] const IPSEC_SA_CONTEXT_ENUM_TEMPLATE0 *enumTemplate,
[out] HANDLE *enumHandle
);
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, optional] enumTemplate
Type : const IPSEC_SA_CONTEXT_ENUM_TEMPLATE0*
Modèle pour restreindre de manière sélective l’énumération.
[out] enumHandle
Type : HANDLE*
Adresse d’une variable HANDLE . Sur le retour de fonction, il contient le handle pour l’énumération de contexte SAP.
Valeur retournée
Type : DWORD
Code/valeur de retour | Description |
---|---|
|
L’énumérateur a été créé 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 enumTemplate a la valeur NULL, tous les objets SA IPsec sont retournés.
L’appelant doit appeler IPsecSaContextDestroyEnumHandle0 pour libérer le handle retourné.
L’appelant a besoin d’un accès FWPM_ACTRL_ENUM et FWPM_ACTRL_READ à la base de données des associations de sécurité IPsec. Pour plus d’informations, consultez Access Control.
IPsecSaContextCreateEnumHandle0 est une implémentation spécifique d’IPsecSaContextCreateEnumHandle. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de 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