Énumération BG_JOB_STATE

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

Syntax

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 est en attente d’exécution. Si un utilisateur se déconnecte pendant le transfert de son travail, le travail passe à l’État en file d’attente.

BG_JOB_STATE_CONNECTING

Non pris en charge.

BG_JOB_STATE_TRANSFERRING

Spécifie que l’optimisation de la remise transfère des données pour le travail.

BG_JOB_STATE_SUSPENDED

Spécifie que le travail est suspendu (suspendu). Pour interrompre un travail, appelez la méthode méthode ibackgroundcopyjob :: suspend . Le travail reste suspendu jusqu’à ce que vous appeliez la méthode méthode ibackgroundcopyjob :: Resume, méthode ibackgroundcopyjob :: Completeou méthode ibackgroundcopyjob :: Cancel .

BG_JOB_STATE_ERROR

Spécifie qu’une erreur irrécupérable s’est produite (le service n’est pas en mesure de transférer le fichier). Si l’erreur, telle qu’une erreur d’accès refusé, peut être corrigée, appelez la méthode méthode ibackgroundcopyjob :: Resume une fois l’erreur corrigée. Toutefois, si l’erreur ne peut pas être corrigée, appelez la méthode méthode ibackgroundcopyjob :: Cancel pour annuler le travail, ou appelez la méthode méthode ibackgroundcopyjob :: Complete pour accepter la partie d’une tâche 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 en état d’erreur temporaire en fonction de la configuration de la nouvelle tentative interne. L’état du travail devient BG_JOB_STATE_ERROR si le travail échoue pour progresser (voir méthode ibackgroundcopyjob :: SetNoProgressTimeout).

BG_JOB_STATE_TRANSFERRED

Spécifie que votre travail a été traité avec succès. Vous devez appeler la méthode méthode ibackgroundcopyjob :: Complete pour accuser réception de la tâche et rendre les fichiers accessibles au client.

BG_JOB_STATE_ACKNOWLEDGED

Spécifie que vous avez appelé la méthode 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 méthode ibackgroundcopyjob :: Cancel pour annuler le travail (supprimer la tâche de la file d’attente de transfert).

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 10, les applications de bureau version 1709 [ uniquement]
Serveur minimal pris en charge
Windows Serveur, version 1709 [ applications de bureau uniquement]
En-tête
Deliveryoptimization. h

Voir aussi

Méthode ibackgroundcopyjob :: GetState