Fonction IPsecSaContextUpdate0 (fwpmu.h)

Article
08/23/2023

La fonction IPsecSaContextUpdate0 met à jour un contexte d’association de sécurité (SA) IPsec.

Syntaxe

DWORD IPsecSaContextUpdate0(
  [in] HANDLE                  engineHandle,
  [in] UINT64                  flags,
  [in] const IPSEC_SA_CONTEXT1 *newValues
);

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

Type : UINT32

Indicateurs indiquant le champ spécifique dans la structure IPSEC_SA_CONTEXT1 en cours de mise à jour.

Valeurs possibles :

Indicateur D’accès partagé IPsec	Signification
IPSEC_SA_DETAILS_UPDATE_TRAFFIC	Mises à jour la structure [IPSEC_SA_DETAILS1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_details1).
IPSEC_SA_DETAILS_UPDATE_UDP_ENCAPSULATION	Mises à jour la structure [IPSEC_SA_DETAILS1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_details1).
IPSEC_SA_BUNDLE_UPDATE_FLAGS	Mises à jour la structure [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1).
IPSEC_SA_BUNDLE_UPDATE_NAP_CONTEXT	Mises à jour la structure [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1).
IPSEC_SA_BUNDLE_UPDATE_KEY_MODULE_STATE	Mises à jour la structure [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1).
IPSEC_SA_BUNDLE_UPDATE_PEER_V4_PRIVATE_ADDRESS	Mises à jour la structure [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1).
IPSEC_SA_BUNDLE_UPDATE_MM_SA_ID	Mises à jour la structure [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1).

[in] newValues

Type : IPSEC_SA_CONTEXT1*

Paire SA entrante et sortante.

Valeur retournée

Type : DWORD

Code/valeur de retour	Description
ERROR_SUCCESS 0	Le contexte SA IPsec a été mis à jour 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.

Notes

IPsecSaContextUpdate0 est une implémentation spécifique d’IPsecSaContextUpdate. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows .

Spécifications


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	fwpmu.h
Bibliothèque	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Voir aussi

IPSEC_SA_CONTEXT1

Partager via