IBackgroundCopyManager ::CreateJob, méthode (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 complet 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 être NULL. Le nom est limité à 256 caractères, sans inclure le terminateur 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 façon 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.

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 de l’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 à la création d’un utilisateur.

Pour connaître les problèmes d’extensibilité, consultez les meilleures pratiques lors de l’utilisation de BITS.

Examples

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

Spécifications

Voir aussi

Création d’un travail

IBackgroundCopyJob

IBackgroundCopyJob ::Resume