ImportSecurityContextA, fonction (sspi.h)

Article
08/26/2023

La fonction ImportSecurityContext importe un contexte de sécurité. Le contexte de sécurité doit avoir été exporté vers le processus appelant ImportSecurityContext par un appel précédent à ExportSecurityContext.

Syntaxe

SECURITY_STATUS SEC_ENTRY ImportSecurityContextA(
  [in]           LPSTR       pszPackage,
  [in]           PSecBuffer  pPackedContext,
  [in, optional] VOID        *Token,
  [out]          PCtxtHandle phContext
);

Paramètres

[in] pszPackage

Chaîne qui contient le nom du package de sécurité vers lequel le contexte de sécurité a été exporté.

[in] pPackedContext

Pointeur vers une mémoire tampon qui contient le contexte de sécurité sérialisé créé par ExportSecurityContext.

[in, optional] Token

Handle du jeton du contexte.

[out] phContext

Handle du nouveau contexte de sécurité créé à partir de pPackedContext. Une fois que vous avez terminé d’utiliser le contexte, supprimez-le en appelant la fonction DeleteSecurityContext .

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_UNKNOWN_CREDENTIALS	Les informations d’identification fournies au package n’ont pas été reconnues.
SEC_E_NO_CREDENTIALS	Aucune information d’identification n’est disponible dans le package de sécurité.
SEC_E_NOT_OWNER	L’appelant de la fonction ne dispose pas des informations d’identification nécessaires.
SEC_E_INSUFFICIENT_MEMORY	La mémoire disponible est insuffisante pour effectuer l’action demandée.
SEC_E_INTERNAL_ERROR	Une erreur s’est produite qui n’a pas été mappée à un code d’erreur SSPI.

Remarques

Notes

L’en-tête sspi.h définit ImportSecurityContext comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de 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

ExportSecurityContext

FreeContextBuffer

Fonctions SSPI

Share via