Partager via

IPsecSaContextUpdate0, fonction (fwpmk.h)

  • Article

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

Syntaxe

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

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

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

Valeurs possibles :

Indicateur SA IPsec Signification
IPSEC_SA_DETAILS_UPDATE_TRAFFIC Met à jour la structure IPSEC_SA_DETAILS1.
IPSEC_SA_DETAILS_UPDATE_UDP_ENCAPSULATION Met à jour la structure IPSEC_SA_DETAILS1.
IPSEC_SA_BUNDLE_UPDATE_FLAGS Met à jour la structure IPSEC_SA_BUNDLE1.
IPSEC_SA_BUNDLE_UPDATE_NAP_CONTEXT Met à jour la structure IPSEC_SA_BUNDLE1.
IPSEC_SA_BUNDLE_UPDATE_KEY_MODULE_STATE Met à jour la structure IPSEC_SA_BUNDLE1.
IPSEC_SA_BUNDLE_UPDATE_PEER_V4_PRIVATE_ADDRESS Met à jour la structure IPSEC_SA_BUNDLE1.
IPSEC_SA_BUNDLE_UPDATE_MM_SA_ID Met à jour la structure IPSEC_SA_BUNDLE1.

[in] newValues

Paire SA entrante et sortante.

Valeur de retour

Retourner le code/la valeur 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). 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

IPsecSaContextUpdate0 est une implémentation spécifique de IPsecSaContextUpdate. 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