Fonction IPsecKeyManagerAddAndRegister0 (fwpmu.h)

Article
03/01/2024

La fonction IPsecKeyManagerAddAndRegister0 inscrit un agent intermédiaire approuvé (TIA) auprès d’IPsec.

Syntaxe

DWORD IPsecKeyManagerAddAndRegister0(
  [in]  HANDLE                             engineHandle,
  [in]  const IPSEC_KEY_MANAGER0           *keyManager,
  [in]  const IPSEC_KEY_MANAGER_CALLBACKS0 *keyManagerCallbacks,
  [out] HANDLE                             *keyMgmtHandle
);

Paramètres

[in] engineHandle

Type : HANDLE

Handle pour une session ouverte au moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.

[in] keyManager

Type : const IPSEC_KEY_MANAGER0*

Ensemble de rappels de gestion de clés qu’IPsec appellera.

[in] keyManagerCallbacks

Type : const IPSEC_KEY_MANAGER_CALLBACKS0*

Ensemble de rappels qui doivent être appelés par IPsec à différentes étapes de la négociation de l’AS.

[out] keyMgmtHandle

Type : HANDLE*

Adresse de l’inscription nouvellement créée.

Valeur retournée

Type : DWORD

Code/valeur de retour	Description
ERROR_SUCCESS 0	Le TIA a été enregistré 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.
FWP_E_ALREADY_EXISTS 0x80320009L	Le TIA n’a pas été enregistré correctement, car un autre TIA a déjà été enregistré pour dicter les clés.
FWP_E_INVALID_INTERVAL 0x80320021L	Le TIA n’a pas été enregistré correctement, car keyDictationTimeoutHint a dépassé la valeur maximale autorisée de 10 secondes.
SEC_E_CANNOT_INSTALL 0x80090307L	Le TIA n’a pas été inscrit correctement, car l’image binaire n’a pas défini la propriété IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY .

Remarques

Si l’indicateur IPSEC_KEY_MANAGER_FLAG_DICTATE_KEY est défini pour keyManager, les trois membres de rappel de keyManagerCallbacks doivent être spécifiés ; sinon, seul le rappel keyNotify doit être spécifié

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.

Configuration requise

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

Voir aussi

IPSEC_KEY_MANAGER0

IPSEC_KEY_MANAGER_CALLBACKS0

Fonctions pam

Partager via