IBitsTokenOptions ::GetHelperTokenFlags, méthode (bits4_0.h)

Retourne les indicateurs d’utilisation d’un jeton associé à un travail de transfert BITS.

Syntaxe

HRESULT GetHelperTokenFlags(
  [out] DWORD *pFlags
);

Paramètres

[out] pFlags

Spécifie l’indicateur d’utilisation à retourner. Ce paramètre doit être défini sur l’une des valeurs suivantes :

Valeur	Signification
BG_TOKEN_LOCAL_FILE 0x0001	Si cet indicateur est spécifié, le jeton d’assistance est utilisé Pour ouvrir le fichier local d’un travail de chargement Pour créer ou renommer le fichier temporaire d’un travail de téléchargement Pour créer ou renommer le fichier de réponse d’un travail de chargement-réponse
BG_TOKEN_NETWORK 0x0002	Si cet indicateur est spécifié, le jeton d’assistance est utilisé Pour ouvrir le fichier distant d’un chargement ou d’un travail de téléchargement SMB (Server Message Block) En réponse à une demande de serveur HTTP ou de proxy pour les informations d’identification NTLM ou Kerberos implicites Une application est nécessaire pour appeler la méthode IBackgroundCopyJob2 ::SetCredentials pour autoriser l’envoi des informations d’identification via HTTP.

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 nécessitaient que les utilisateurs BITS disposent de privilèges d’administrateur pour obtenir des indicateurs de jeton d’assistance avec cette méthode. À compter de Windows 10 version 1607, les utilisateurs BITS non administrateurs peuvent utiliser cette méthode pour obtenir des indicateurs d’utilisation des jetons 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 exécutés 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 des indicateurs de jeton d’assistance, tant que le SID du jeton du thread de l’appelant est le même que le 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

Voir aussi

IBitsTokenOptions