Fonction ImpersonateSelf (securitybaseapi.h)
La fonction ImpersonateSelf obtient un jeton d’accès qui emprunte l’identité du contexte de sécurité du processus appelant. Le jeton est affecté au thread appelant.
Syntaxe
BOOL ImpersonateSelf(
[in] SECURITY_IMPERSONATION_LEVEL ImpersonationLevel
);
Paramètres
[in] ImpersonationLevel
Spécifie un type énuméré SECURITY_IMPERSONATION_LEVEL qui fournit le niveau d’emprunt d’identité du nouveau jeton.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
La fonction ImpersonateSelf est utilisée pour des tâches telles que l’activation d’un privilège pour un thread unique plutôt que pour l’ensemble du processus ou pour la modification de la liste de contrôle d’accès discrétionnaire (DACL) par défaut pour un thread unique.
Le serveur peut appeler la fonction RevertToSelf lorsque l’emprunt d’identité est terminé.
Pour que cette fonction réussisse, la liste DACL protégeant le jeton de processus doit accorder au TOKEN_DUPLICATE droit à lui-même.
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 | securitybaseapi.h (inclure Windows.h) |
| Bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |
Voir aussi
Fonctions de Access Control client/serveur