Fonction IPsecSaContextCreate0 (fwpmu.h)

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

Syntaxe

DWORD IPsecSaContextCreate0(
  [in]            HANDLE               engineHandle,
  [in]            const IPSEC_TRAFFIC0 *outboundTraffic,
  [out, optional] UINT64               *inboundFilterId,
  [out]           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] outboundTraffic

Type : IPSEC_TRAFFIC0*

Trafic sortant de l’entité d’accès partagé.

[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 sera défini sur 0.

[out] id

Type : UINT64*

Identificateur du contexte SA IPsec.

Valeur retournée

Type : DWORD

Notes

Cette fonction ne peut pas être appelée à partir d’une transaction. Il é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 FWPM_ACTRL_ADD accès à la base de données des associations de sécurité IPsec. Pour plus d’informations, consultez Access Control.

Spécifications

Voir aussi

IPSEC_TRAFFIC0