Méthode IBackgroundCopyManager::CreateJob

Article
06/12/2023

Crée un travail.

Syntaxe

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

Paramètres

pDisplayName [in]: 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, à l’exception de la marque de fin Null.
Type [in]: 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 .
pJobID [out]: 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.
ppJob [out]: 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	La nouvelle tâche a été générée avec succès.

Notes

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.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server, version 1709 [applications de bureau uniquement]
En-tête	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Bibliothèque	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyManager est défini comme 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C

Voir aussi

IBackgroundCopyManager
IBackgroundCopyJob
IBackgroundCopyJob::Resume