Fonction IPsecSaContextCreate1 (fwpmu.h)

Article
02/29/2024

La fonction IPsecSaContextCreate1 crée un contexte d’association de sécurité (SA) IPsec.

RemarqueIPsecSaContextCreate1 est l’implémentation spécifique d’IPsecSaContextCreate utilisée dans Windows 7 et versions ultérieures. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows . Pour Windows Vista, IPsecSaContextCreate0 est disponible.

Syntaxe

DWORD IPsecSaContextCreate1(
  [in]            HANDLE                              engineHandle,
  [in]            const IPSEC_TRAFFIC1                *outboundTraffic,
  [in, optional]  const IPSEC_VIRTUAL_IF_TUNNEL_INFO0 *virtualIfTunnelInfo,
  [out, optional] UINT64                              *inboundFilterId,
  [out]           UINT64                              *id
);

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

Type : IPSEC_TRAFFIC1*

Trafic sortant de l’AS.

[in, optional] virtualIfTunnelInfo

Type : IPSEC_VIRTUAL_IF_TUNNEL_INFO0*

Détails liés au tunneling d’interface virtuelle.

[out, optional] inboundFilterId

Type : UINT64*

Identificateur de filtre facultatif du filtre entrant mis en cache correspondant au paramètre outboundTraffic spécifié par l’appelant. Le moteur de filtrage de base (BFE) peut mettre en cache l’identificateur de filtre entrant et retourner la valeur mise en cache, si disponible. L’appelant doit gérer le cas lorsque BFE n’a pas de valeur mise en cache, auquel cas ce paramètre est défini sur 0.

[out] id

Type : UINT64*

Identificateur du contexte SA IPsec.

Valeur retournée

Type : DWORD

Code/valeur de retour	Description
ERROR_SUCCESS 0	Le contexte SA IPsec a été créé avec succès.
code d’erreur FWP_E_* 0x80320001—0x80320039	Une 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

Cette fonction ne peut pas être appelée à partir d’une transaction. Elle échoue avec FWP_E_TXN_IN_PROGRESS. Pour plus d’informations sur les transactions, consultez Gestion des objets.

Cette fonction ne peut pas être appelée à partir d’une session dynamique. L’appel échoue avec FWP_E_DYNAMIC_SESSION_IN_PROGRESS. Pour plus d’informations sur les sessions dynamiques, consultez Gestion des objets.

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

Configuration requise

Condition requise	Valeur
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_TRAFFIC1

IPSEC_VIRTUAL_IF_TUNNEL_INFO0

Partager via