Partager via


Fonction IPsecSaContextGetSpi0 (fwpmu.h)

La fonction IPsecSaContextGetSpi0 récupère l’index des paramètres de sécurité (SPI) pour un contexte d’association de sécurité (SA).

RemarqueIPsecSaContextGetSpi0 est l’implémentation spécifique d’IPsecSaContextGetSpi utilisée dans Windows Vista. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows . Pour Windows 7 et versions ultérieures, IPsecSaContextGetSpi1 est disponible.
 

Syntaxe

DWORD IPsecSaContextGetSpi0(
  [in]  HANDLE              engineHandle,
  [in]  UINT64              id,
  [in]  const IPSEC_GETSPI0 *getSpi,
  [out] IPSEC_SA_SPI        *inboundSpi
);

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

Type : UINT64

Identificateur d’exécution pour le contexte SAP. Cet identificateur a été reçu du système lorsque l’application a appelé IPsecSaContextCreate0.

[in] getSpi

Type : IPSEC_GETSPI0*

Trafic IPsec entrant.

[out] inboundSpi

Type : IPSEC_SA_SPI*

SPI SA entrant. Le type de données IPSEC_SA_SPI est mappé au type de données UINT32 .

Valeur retournée

Type : DWORD

Code/valeur de retour Description
ERROR_SUCCESS
0
Le SPI du contexte SA IPsec a été récupéré 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.

Remarques

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.

Configuration requise

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

Voir aussi

IPSEC_GETSPI0

IPsecSaContextCreate0