Partager via


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

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