Méthode IBackgroundCopyManager ::CreateJob (bits.h)

Article
08/22/2023

Crée un travail.

Syntaxe

HRESULT CreateJob(
  [in]  LPCWSTR            DisplayName,
  [in]  BG_JOB_TYPE        Type,
  [out] GUID               *pJobId,
  [out] IBackgroundCopyJob **ppJob
);

Paramètres

[in] DisplayName

Chaîne terminée par null qui contient un nom d’affichage pour le travail. En règle générale, le nom d’affichage est utilisé pour identifier le travail dans une interface utilisateur. Notez que plusieurs travaux peuvent avoir le même nom d’affichage. Ne doit pas avoir la valeur NULL. Le nom est limité à 256 caractères, sans compter la fin null.

[in] Type

Type de travail de transfert, tel que BG_JOB_TYPE_DOWNLOAD. Pour obtenir la liste des types de transfert, consultez l’énumération BG_JOB_TYPE .

[out] pJobId

Identifie de manière unique votre travail dans la file d’attente. Utilisez cet identificateur lorsque vous appelez la méthode IBackgroundCopyManager ::GetJob pour obtenir un travail à partir de la file d’attente.

[out] ppJob

Pointeur d’interface IBackgroundCopyJob que vous utilisez pour modifier les propriétés du travail et spécifier les fichiers à transférer. Pour activer le travail dans la file d’attente, appelez la méthode IBackgroundCopyJob ::Resume . Relâchez ppJob lorsque vous avez terminé.

Valeur retournée

Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.

Code de retour	Description
S_OK	Le nouveau travail a été généré avec succès.
E_INVALIDARG	Le nom d’affichage est trop long.
BG_E_TOO_MANY_JOBS_PER_MACHINE	Le paramètre MaxJobsPerMachine stratégie de groupe détermine le nombre de travaux qui peuvent être créés sur l’ordinateur. L’ajout de ce travail dépasse la limite MaxJobsPerMachine.
BG_E_TOO_MANY_JOBS_PER_USER	Le paramètre de stratégie de groupe MaxJobsPerUser détermine le nombre de travaux qu’un utilisateur peut créer. L’ajout de ce travail dépasse la limite MaxJobsPerUser.

Remarques

Seul l’utilisateur qui crée le travail ou un utilisateur disposant de privilèges d’administrateur peut ajouter des fichiers au travail et modifier les propriétés du travail.

Par défaut, BITS prend en charge un maximum de 300 travaux à la fois. Un seul utilisateur peut créer un maximum de 60 travaux à la fois. La limite utilisateur ne s’applique pas aux administrateurs ou aux comptes de service. Pour modifier ces valeurs par défaut, définissez les stratégies de groupe MaxJobsPerMachine et MaxJobsPerUser , respectivement.

Avant Windows Vista : Il n’existe aucune limite quant au nombre de travaux pris en charge par BITS ou qu’un utilisateur peut créer.

Pour connaître les problèmes de scalabilité, consultez Meilleures pratiques lors de l’utilisation de BITS.

Exemples

Pour obtenir un exemple qui crée un travail, consultez Création d’un travail.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
Plateforme cible	Windows
En-tête	bits.h
Bibliothèque	Bits.lib
DLL	QmgrPrxy.dll

Voir aussi

Création d’un travail

IBackgroundCopyJob

IBackgroundCopyJob ::Resume

Partager via