Partager via


IPsecSaContextExpire0, fonction (fwpmk.h)

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

Syntaxe

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

Paramètres

[in] engineHandle

Gérer une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session au moteur de filtre.

[in] id

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

Valeur de retour

Retourner le code/la valeur Description
ERROR_SUCCESS
0
Le contexte SA IPsec a expiré.
code d’erreur FWP_E_*
0x80320001 — 0x80320039
Erreur spécifique à la plateforme de filtrage Windows (PAM). Consultez codes d’erreur PAM pour plus d’informations.
code d’erreur RPC_*
0x80010001 — 0x80010122
Échec de la communication avec le moteur de pare-feu distant ou local.
autres codes NTSTATUS Une erreur s’est produite.

Remarques

Lorsqu’un contexte d’accès partagé a expiré, la sa sortante correspondante est supprimée immédiatement, tandis que la suppression sa entrante est reportée pendant une minute. Cela permet de traiter tout trafic protégé IPsec entrant qui peut toujours se trouver sur le câble.

L’appelant a besoin de DELETE l’accès à la base de données des associations de sécurité IPsec. Pour plus d’informations, consultez contrôle d’accès.

IPsecSaContextExpire0 est une implémentation spécifique de IPsecSaContextExpire . Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows Vista.
plateforme cible Universel
d’en-tête fwpmk.h
bibliothèque fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Voir aussi