énumération BG_JOB_STATE

L’énumération BG_JOB_STATE définit des valeurs constantes pour les différents états d’un travail.

Syntaxe

typedef enum  { 
  BG_JOB_STATE_QUEUED,
  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
} BG_JOB_STATE;

Constantes

BG_JOB_STATE_QUEUED

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

Non pris en charge.

BG_JOB_STATE_TRANSFERRING

Spécifie que l’optimisation de la distribution 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 . Le travail reste suspendu jusqu’à ce que vous appeliez la méthode IBackgroundCopyJob::Resume, IBackgroundCopyJob::Complete ou 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 la méthode IBackgroundCopyJob::Resume une fois l’erreur corrigée. Toutefois, si l’erreur ne peut pas être corrigée, appelez la méthode IBackgroundCopyJob::Cancel pour annuler le travail, ou appelez la 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. L’optimisation de la distribution retentera les travaux dans l’état d’erreur temporaire en fonction de la configuration de nouvelle tentative interne. L’état du travail devient BG_JOB_STATE_ERROR si le travail ne parvient pas à progresser (voir IBackgroundCopyJob::SetNoProgressTimeout).

BG_JOB_STATE_TRANSFERRED

Spécifie que votre travail a été traité avec succès. Vous devez appeler la méthode IBackgroundCopyJob::Complete pour confirmer l’achèvement du travail et 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é la méthode IBackgroundCopyJob::Cancel pour annuler le travail (supprimer le travail de la file d’attente de transfert).

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

Voir aussi

IBackgroundCopyJob::GetState