Partager via


énumération BG_JOB_STATE (bits.h)

Définit des constantes qui spécifient les différents états d’un travail.

Syntax

typedef enum BG_JOB_STATE {
  BG_JOB_STATE_QUEUED = 0,
  BG_JOB_STATE_CONNECTING,
  BG_JOB_STATE_TRANSFERRING,
  BG_JOB_STATE_SUSPENDED,
  BG_JOB_STATE_ERROR,
  BG_JOB_STATE_TRANSIENT_ERROR,
  BG_JOB_STATE_TRANSFERRED,
  BG_JOB_STATE_ACKNOWLEDGED,
  BG_JOB_STATE_CANCELLED
} ;

Constantes

 
BG_JOB_STATE_QUEUED
Valeur : 0
Spécifie que le travail se trouve dans la file d’attente et qu’il attend de s’exécuter. Si un utilisateur se déconnecte pendant le transfert de son travail, le travail passe à l’état mis en file d’attente.
BG_JOB_STATE_CONNECTING
Spécifie que BITS tente de se connecter au serveur. Si la connexion réussit, l’état du travail devient BG_JOB_STATE_TRANSFERRING ; sinon, l’état devient BG_JOB_STATE_TRANSIENT_ERROR.
BG_JOB_STATE_TRANSFERRING
Spécifie que BITS transfère des données pour le travail.
BG_JOB_STATE_SUSPENDED
Spécifie que le travail est suspendu (suspendu). Pour suspendre un travail, appelez la méthode IBackgroundCopyJob ::Suspend. BITS suspend automatiquement un travail lors de sa création. Le travail reste suspendu jusqu’à ce que vous appeliez la méthode IBackgroundCopyJob ::Resume, la méthode IBackgroundCopyJob ::Complete ou la méthode IBackgroundCopyJob ::Cancel.
BG_JOB_STATE_ERROR
Spécifie qu’une erreur irrécupérable s’est produite (le service ne peut pas transférer le fichier). Si l’erreur, telle qu’une erreur de refus d’accès, peut être corrigée, appelez le
Méthode IBackgroundCopyJob ::Resume une fois l’erreur corrigée. Toutefois, si l’erreur ne peut pas être corrigée, appelez le
Méthode IBackgroundCopyJob ::Cancel pour annuler le travail ou appeler le
Méthode IBackgroundCopyJob ::Complete pour accepter la partie d’un travail de téléchargement qui a été transférée avec succès.
BG_JOB_STATE_TRANSIENT_ERROR
Spécifie qu’une erreur récupérable s’est produite. BITS réessayera les travaux dans l’état d’erreur temporaire en fonction de l’intervalle de nouvelle tentative que vous spécifiez (voir méthode IBackgroundCopyJob ::SetMinimumRetryDelay). L’état du travail devient BG_JOB_STATE_ERROR si le travail ne parvient pas à progresser (voir méthode IBackgroundCopyJob ::SetNoProgressTimeout).

BITS ne retente pas le travail si une déconnexion réseau ou une erreur de verrouillage de disque s’est produite (par exemple, chkdsk est en cours d’exécution), ou si le stratégie de groupe MaxInternetBandwidth est égal à zéro.
BG_JOB_STATE_TRANSFERRED
Spécifie que votre travail a été traité avec succès. Vous devez appeler le
Méthode IBackgroundCopyJob ::Complete d’accuser réception de la fin du travail et de mettre les fichiers à la disposition du client.
BG_JOB_STATE_ACKNOWLEDGED
Spécifie que vous avez appelé la méthode IBackgroundCopyJob ::Complete pour confirmer que votre travail s’est terminé avec succès.
BG_JOB_STATE_CANCELLED
Spécifie que vous avez appelé le
Méthode IBackgroundCopyJob ::Cancel pour annuler le travail (autrement dit, pour supprimer le travail de la file d’attente de transfert).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP
Serveur minimal pris en charge Windows Server 2003
En-tête bits.h

Voir aussi