Fonction IkeextSaGetById2 (fwpmu.h)
La fonction IkeextSaGetById2 récupère une association de sécurité IKE/AuthIP à partir de la base de données.
Syntaxe
DWORD IkeextSaGetById2(
[in] HANDLE engineHandle,
[in] UINT64 id,
[in, optional] GUID *saLookupContext,
[out] IKEEXT_SA_DETAILS2 **sa
);
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] id
Type : UINT64
Identificateur SA.
[in, optional] saLookupContext
Type : GUID*
Pointeur facultatif vers le contexte de recherche SA propagé à partir de l’AS aux connexions de données circulant sur cette SA. Il est mis à la disposition de toute application qui interroge les propriétés de sécurité du socket à l’aide de la fonction WSAQuerySocketSecurity de l’API Winsock, ce qui permet à l’application d’obtenir des informations d’authentification IPsec détaillées pour sa connexion.
[out] sa
Type : IKEEXT_SA_DETAILS2**
Adresse des détails de l’AS.
Valeur retournée
Type : DWORD
Code/valeur de retour | Description |
---|---|
|
L’AS a été récupérée 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
L’appelant doit libérer sa par un appel à FwpmFreeMemory0.
L’appelant doit accéder FWPM_ACTRL_READ à la base de données des associations de sécurité IKE/AuthIP. Pour plus d’informations, consultez Access Control.
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