Share via


QuerySecurityContextToken, fonction (sspi.h)

Obtient le jeton d’accès pour un contexte de sécurité client et l’utilise directement.

Syntaxe

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY QuerySecurityContextToken(
  [in]  PCtxtHandle phContext,
  [out] void        **Token
);

Paramètres

[in] phContext

Handle du contexte à interroger.

[out] Token

Handle retourné au jeton d’accès.

Valeur retournée

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

Si la fonction échoue, elle retourne un code d’erreur différent de zéro. Un retour de code d’erreur possible est SEC_E_INVALID_HANDLE.

Remarques

Cette fonction est appelée par une application serveur pour contrôler l’emprunt d’identité en dehors de la couche SSPI, par exemple lors du lancement d’un processus enfant. Le handle retourné doit être fermé avec CloseHandle lorsque le handle n’est plus nécessaire.

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

CloseHandle

Fonctions SSPI