Partager via

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

  • Article

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

Syntaxe

HRESULT SetHelperTokenFlags(
  DWORD UsageFlags
);

Paramètres

UsageFlags

Spécifie l’indicateur d’utilisation. 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 IBackgroundCopyJob2 ::SetCredentials (..., NULL, NULL) pour permettre 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 indicateurs d’utilisation du jeton d’assistance spécifient les ressources à accéder à l’aide du contexte de sécurité du jeton d’assistance. BITS accède à toutes les autres ressources à l’aide du contexte de sécurité du propriétaire du travail. Par exemple, le certificat client est accessible à l’aide de l’identité du propriétaire du travail.

Si un certificat client est spécifié et que le propriétaire du travail BITS n’est pas le compte LocalSystem, la définition du paramètre UsageFlag sur BG_TOKEN_NETWORK entraîne l’échec du travail avec le code d’erreur 0x80072f9a (ERROR_WINHTTP_CLIENT_CERT_NO_ACCESS_PRIVATE_KEY).

Les implémentations plus anciennes nécessitaient que les utilisateurs BITS disposent de privilèges d’administrateur pour définir des indicateurs d’utilisation des jetons d’assistance avec cette méthode. À compter de Windows 10 version 1607, les utilisateurs BITS non administrateurs peuvent utiliser cette méthode pour définir des indicateurs d’utilisation de jeton d’assistance non administrateur sur les travaux BITS dont ils sont propriétaires. 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 de définir des indicateurs d’utilisation des jetons 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 , et que le jeton d’assistance actuellement défini (le cas échéant) n’a pas le SID d’administrateur (DOMAIN_ALIAS_RID_ADMINS) activé.

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