Méthode IBitsTokenOptions ::GetHelperTokenSid (bits4_0.h)
Retourne le SID du jeton d’assistance s’il est défini.
Syntaxe
HRESULT GetHelperTokenSid(
[out] LPWSTR *pSid
);
Paramètres
[out] pSid
Retourne le SID récupéré à partir du paramètre TokenInformation de la fonction GetTokenInformation . Si aucun SID n’est récupéré, ce paramètre est défini sur NULL.
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Les implémentations plus anciennes exigeaient effectivement que les utilisateurs BITS disposent de privilèges d’administrateur pour obtenir le SID de jeton d’assistance avec cette méthode. À compter de Windows 10 version 1607, les utilisateurs BITS non-administrateur peuvent utiliser cette méthode pour obtenir le SID de jeton d’assistance sur les travaux BITS qu’ils possèdent. Cette modification permet aux utilisateurs BITS non-administrateurs (tels que les services de téléchargement en arrière-plan s’exécutant sous le compte NetworkService) d’utiliser efficacement les jetons d’assistance.
Plus précisément, l’implémentation a été modifiée pour permettre aux utilisateurs sans privilèges d’administrateur d’obtenir le SID de jeton d’assistance, à condition que le SID du jeton du thread de l’appelant soit identique au SID du compte d’utilisateur du propriétaire du travail pendant l’appel IBackgroundCopyJob ::QueryInterface .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 |
| Serveur minimal pris en charge | Windows Server 2008 R2 |
| Plateforme cible | Windows |
| En-tête | bits4_0.h |
| Composant redistribuable | Windows Management Framework sur Windows Vista avec SP1, Windows Vista avec SP2 et Windows Server 2008 avec SP2 |