IBackgroundCopyJob ::SetMinimumRetryDelay, méthode (bits.h)
Définit la durée minimale pendant laquelle BITS attend après avoir rencontré une condition d’erreur temporaire avant d’essayer de transférer le fichier.
Syntaxe
HRESULT SetMinimumRetryDelay(
[in] ULONG Seconds
);
Paramètres
[in] Seconds
Durée minimale, en secondes, pendant laquelle BITS attend après avoir rencontré une erreur temporaire avant de tenter de transférer le fichier. Le délai de nouvelle tentative par défaut est de 600 secondes (10 minutes). Le délai minimal de nouvelle tentative que vous pouvez spécifier est de 5 secondes. Si vous spécifiez une valeur inférieure à 5 secondes, BITS la remplace par 5 secondes. Si la valeur dépasse la valeur no-progress-timeout récupérée à partir de la méthode GetNoProgressTimeout , BITS ne réessaye pas le transfert et déplace le travail à l’état BG_JOB_STATE_ERROR.
Valeur retournée
Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.
| Code de retour | Description |
|---|---|
|
Le délai de nouvelle tentative a été correctement défini. |
|
L’état du travail ne peut pas être BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED. |
Remarques
Pour démarrer le travail avant l’expiration de la période minimale de nouvelle tentative, appelez la méthode IBackgroundCopyJob ::Resume .
BITS ne retente pas le travail si une erreur de déconnexion réseau ou 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.
Note La modification de l’horloge système n’affecte pas le délai minimal de nouvelle tentative. Par exemple, si l’heure actuelle est 14 :00 et que BITS doit réessayer le travail à 14 :10, le fait de déplacer l’horloge système vers l’avant dix minutes ne signifie pas que BITS réessayera le travail plus tôt , bits réessayera toujours le travail dans dix minutes. 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 |
Voir aussi
IBackgroundCopyJob ::GetMinimumRetryDelay