ImportSecurityContextW, fonction (sspi.h)

Article
11/20/2024

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

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ImportSecurityContextW(
  [in]           PSECURITY_STRING 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 laquelle le contexte de sécurité a été exporté.

[in] pPackedContext

Pointeur vers une mémoire tampon qui contient le contexte de sécurité de 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. Lorsque vous avez terminé d’utiliser le contexte, supprimez-le en appelant la fonction DeleteSecurityContext.

Valeur de retour

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

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

Retourner le code	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 n’a pas les informations d’identification nécessaires.
SEC_E_INSUFFICIENT_MEMORY	Il n’y a pas suffisamment de mémoire disponible pour terminer 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

Note

L’en-tête sspi.h définit ImportSecurityContext comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	sspi.h (include Security.h)
bibliothèque	Secur32.lib
DLL	Secur32.dll

Voir aussi

ExportSecurityContext

FreeContextBuffer

fonctions SSPI

Partager via