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 |