IBackgroundCopyJob ::SetNoProgressTimeout, méthode (bits.h)
Définit la durée pendant laquelle BITS tente de transférer le fichier après qu’une condition d’erreur temporaire se produit. En cas de progression, le minuteur est réinitialisé.
Syntaxe
HRESULT SetNoProgressTimeout(
[in] ULONG Seconds
);
Paramètres
[in] Seconds
Durée, en secondes, pendant laquelle BITS tente de transférer le fichier après la première erreur temporaire. La période de nouvelle tentative par défaut est de 1 209 600 secondes (14 jours). Définissez la période de nouvelle tentative sur 0 pour empêcher les nouvelles tentatives et forcer le travail à passer à l’état BG_JOB_STATE_ERROR pour toutes les erreurs. Si la valeur de la période de nouvelle tentative dépasse la valeur de stratégie de groupe JobInactivityTimeout (valeur par défaut de 90 jours), BITS annule le travail après le dépassement de la valeur de stratégie.
Valeur retournée
Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.
| Code de retour | Description |
|---|---|
|
La période de nouvelle tentative a été correctement définie. |
|
L’état du travail ne peut pas être BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED. |
Remarques
Si BITS ne progresse pas pendant la période de nouvelle tentative, il déplace l’état de la tâche de BG_JOB_STATE_TRANSIENT_ERROR à BG_JOB_STATE_ERROR. Si vous demandez une notification d’erreur, BITS appelle votre rappel JobError .
Note La modification de l’horloge système n’affecte pas la période de nouvelle tentative. Par exemple, si la période de nouvelle tentative expire dans 14 jours, le fait de faire avancer l’horloge système de 14 jours ou plus ne signifie pas que la période de nouvelle tentative arrive à expiration anticipée . La période de nouvelle tentative expirera toujours dans 14 jours. Pour refléter la modification de l’horloge système dans BITS, vous devez redémarrer l’ordinateur ou le service BITS.
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 |