Fonction IPsecKeyManagerAddAndRegister0 (fwpmu.h)
La fonction IPsecKeyManagerAddAndRegister0 inscrit un agent intermédiaire approuvé (TIA) auprès d’IPsec.
Syntaxe
DWORD IPsecKeyManagerAddAndRegister0(
[in] HANDLE engineHandle,
[in] const IPSEC_KEY_MANAGER0 *keyManager,
[in] const IPSEC_KEY_MANAGER_CALLBACKS0 *keyManagerCallbacks,
[out] HANDLE *keyMgmtHandle
);
Paramètres
[in] engineHandle
Type : HANDLE
Handle pour une session ouverte au moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.
[in] keyManager
Type : const IPSEC_KEY_MANAGER0*
Ensemble de rappels de gestion de clés qu’IPsec appellera.
[in] keyManagerCallbacks
Type : const IPSEC_KEY_MANAGER_CALLBACKS0*
Ensemble de rappels qui doivent être appelés par IPsec à différentes étapes de la négociation de l’AS.
[out] keyMgmtHandle
Type : HANDLE*
Adresse de l’inscription nouvellement créée.
Valeur retournée
Type : DWORD
Code/valeur de retour | Description |
---|---|
|
Le TIA a été enregistré 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. |
|
Le TIA n’a pas été enregistré correctement, car un autre TIA a déjà été enregistré pour dicter les clés. |
|
Le TIA n’a pas été enregistré correctement, car keyDictationTimeoutHint a dépassé la valeur maximale autorisée de 10 secondes. |
|
Le TIA n’a pas été inscrit correctement, car l’image binaire n’a pas défini la propriété IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY . |
Remarques
Si l’indicateur IPSEC_KEY_MANAGER_FLAG_DICTATE_KEY est défini pour keyManager, les trois membres de rappel de keyManagerCallbacks doivent être spécifiés ; sinon, seul le rappel keyNotify doit être spécifié
Cette fonction ne peut pas être appelée à partir d’une transaction. Il échoue avec FWP_E_TXN_IN_PROGRESS. Pour plus d’informations sur les transactions, consultez Gestion des objets.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2012 [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