Partager via


Fonction IPsecSaContextExpire0 (fwpmu.h)

La fonction IPsecSaContextExpire0 indique qu’un contexte d’association de sécurité IPsec (SA) doit avoir expiré.

Syntaxe

DWORD IPsecSaContextExpire0(
  [in] HANDLE engineHandle,
  [in] UINT64 id
);

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] id

Type : UINT64

Identificateur d’exécution pour le contexte SAP. Cet identificateur a été reçu du système lorsque l’application a appelé IPsecSaContextCreate0.

Valeur retournée

Type : DWORD

Code/valeur de retour Description
ERROR_SUCCESS
0
Le contexte SA IPsec a expiré avec succès.
code d’erreur FWP_E_*
0x80320001 0x80320039
Erreur spécifique à la plateforme de filtrage Windows (PAM). Pour plus d’informations, consultez Codes d’erreur PAM .
code d’erreur RPC_*
0x80010001 — 0x80010122
Échec de la communication avec le moteur de pare-feu distant ou local.

Remarques

Lorsqu’un contexte d’accès partagé a expiré, l’autorité de disponibilité sortante correspondante est supprimée immédiatement, tandis que la suppression d’autorité de disponibilité entrante est reportée d’une minute. Cela permet le traitement de tout trafic entrant protégé par IPsec qui peut encore se trouver sur le réseau.

L’appelant a besoin d’un accès DELETE à la base de données des associations de sécurité IPsec. Pour plus d’informations, consultez Access Control.

IPsecSaContextExpire0 est une implémentation spécifique d’IPsecSaContextExpire. 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

IPsecSaContextCreate0