ExportSecurityContext, fonction (sspi.h)

Article
03/02/2024

La fonction ExportSecurityContext crée une représentation sérialisée d’un contexte de sécurité qui peut être importée ultérieurement dans un autre processus en appelant
ImportSecurityContext. Le processus qui importe le contexte de sécurité doit être en cours d’exécution sur le même ordinateur que le processus qui a appelé ExportSecurityContext.

Syntaxe

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ExportSecurityContext(
  [in]            PCtxtHandle phContext,
  [in]            ULONG       fFlags,
  [out]           PSecBuffer  pPackedContext,
  [out, optional] void        **pToken
);

Paramètres

[in] phContext

Handle du contexte de sécurité à exporter.

[in] fFlags

Ce paramètre peut être une combinaison de bits-OR des valeurs suivantes.

Valeur	Signification
SECPKG_CONTEXT_EXPORT_RESET_NEW 1 (0x1)	Le nouveau contexte de sécurité est réinitialisé à son état initial.
SECPKG_CONTEXT_EXPORT_DELETE_OLD 2 (0x2)	L’ancien contexte de sécurité est supprimé.
SECPKG_CONTEXT_EXPORT_TO_KERNEL 4 (0x4)	Cette valeur n’est pas prise en charge. Windows Server 2003 et Windows XP/2000 : Le contexte de sécurité doit être exporté vers le noyau. Cette valeur est prise en charge uniquement en mode noyau Schannel.

[out] pPackedContext

Pointeur vers une mémoire tampon de type SECBUFFER_EMPTY qui reçoit le contexte de sécurité sérialisé . Lorsque vous avez terminé d’utiliser ce contexte, libérez-le en appelant la fonction FreeContextBuffer .

[out, optional] pToken

Pointeur pour recevoir le handle du jeton du contexte.

Lorsque vous avez terminé d’utiliser le jeton utilisateur, relâchez le handle en appelant la fonction CloseHandle .

Valeur retournée

Si la fonction réussit, la fonction retourne SEC_E_OK.

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants.

Code de retour	Description
SEC_E_INSUFFICIENT_MEMORY	La mémoire disponible est insuffisante pour effectuer l’action demandée.
SEC_E_INVALID_HANDLE	Le paramètre phContext ne pointe pas vers un handle valide.
SEC_E_NOT_SUPPORTED	Le mode noyau Schannel ne prend pas en charge cette fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	sspi.h (include Security.h)
Bibliothèque	Secur32.lib
DLL	Secur32.dll

Voir aussi

FreeContextBuffer

ImportSecurityContext

Fonctions SSPI

Partager via