Méthode IBackgroundCopyManager::CreateJob
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 |
|---|---|
|
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 |
|
| IDL |
|
| Bibliothèque |
|
| DLL |
|
| IID |
IID_IBackgroundCopyManager est défini comme 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C |