Partager via

IPsecSaContextCreate0, fonction (fwpmk.h)

  • Article

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

Syntaxe

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

Trafic sortant de l’accès partagé.

[out, optional] inboundFilterId

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, le cas échéant. L’appelant doit gérer le cas où BFE n’a pas de valeur mise en cache, auquel cas ce paramètre est défini sur 0.

[out] id

Identificateur du contexte SA IPsec.

Valeur de retour

Retourner le code/la valeur Description
ERROR_SUCCESS
0		 Le contexte SA IPsec a été créé 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

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 de FWPM_ACTRL_ADD'accès à la base de données des associations de sécurité IPsec. Pour plus d’informations, consultez contrôle d’accès.

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