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