Partager via


Fonction de rappel SpGetContextTokenFn (ntsecpkg.h)

Obtient le jeton à emprunter l’identité. La fonction SpGetContextToken est utilisée par la fonction SSPI ImpersonateSecurityContext pour obtenir le jeton à emprunter.

Syntaxe

SpGetContextTokenFn Spgetcontexttokenfn;

NTSTATUS Spgetcontexttokenfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [out] PHANDLE ImpersonationToken
)
{...}

Paramètres

[in] ContextHandle

Handle du contexte à emprunter l’identité.

[out] ImpersonationToken

Pointeur qui reçoit un handle vers le jeton pour le contexte spécifié. Retournez le handle au jeton sans d’abord dupliquer le handle ou le jeton.

Valeur retournée

Si la fonction réussit, retournez STATUS_SUCCESS.

Si la fonction échoue, retourne un code NTSTATUS qui indique la raison de son échec. La liste suivante répertorie une raison courante de l’échec et le code d’erreur que la fonction doit retourner.

Code de retour Description
SEC_E_INVALID_HANDLE
Le handle n’est pas valide.

Remarques

SSP/APs doivent implémenter la fonction SpGetContextToken ; toutefois, le nom réel donné à l’implémentation appartient au développeur.

Un pointeur vers la fonction SpGetContextToken est disponible dans la structure SECPKG_USER_FUNCTION_TABLE reçue de la fonction SpUserModeInitialize .

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 ntsecpkg.h

Voir aussi

ImpersonateSecurityContext

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize