É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 |
|