Méthode IBackgroundCopyJob ::Resume (bits.h)

  • Article

Active un nouveau travail ou redémarre un travail qui a été suspendu.

Syntaxe

HRESULT Resume();

Valeur de retour

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

Code de retour Description
S_OK
 Le travail a été correctement redémarré.
BG_E_EMPTY
 Aucun fichier à transférer.
BG_E_INVALID_STATE
 L’état du travail ne peut pas être BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED.

Remarques

Lorsque vous créez un travail, celui-ci est initialement suspendu. L’appel de Resume déplace le travail de l’état suspendu à l’état mis en file d’attente. Le travail reste dans l’état mis en file d’attente jusqu’à ce que le planificateur détermine que c’est au tour du travail de transférer des fichiers. Notez que le travail doit contenir un ou plusieurs fichiers avant d’appeler cette méthode. Si le travail est de type BG_JOB_TYPE_UPLOAD_REPLY et que vous souhaitez spécifier le nom du fichier de réponse, vous devez appeler la méthode IBackgroundCopyJob2 ::SetReplyFileName avant d’appeler Resume.

Si un travail est dans l’état BG_JOB_STATE_TRANSIENT_ERROR ou BG_JOB_STATE_ERROR, appelez la méthode Resume pour redémarrer le travail après avoir corrigé l’erreur.

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

IBackgroundCopyJob ::Cancel

IBackgroundCopyJob ::Suspend