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 de tenter de transférer le fichier.

Syntaxe

HRESULT SetMinimumRetryDelay(
  [in] ULONG Seconds
);

Paramètres

[in] Seconds

Durée minimale, en secondes, que 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 remplace la valeur par 5 secondes. Si la valeur dépasse la valeur de délai d’attente sans progression récupérée à partir de la méthode GetNoProgressTimeout , BITS n’effectue pas de nouvelle tentative de transfert et déplace le travail vers l’état BG_JOB_STATE_ERROR.

Valeur retournée

Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.

Remarques

Pour démarrer le travail avant l’expiration de la période de nouvelle tentative minimale, appelez la méthode IBackgroundCopyJob ::Resume .

BITS n’effectue pas de nouvelle tentative de 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 la stratégie de groupe MaxInternetBandwidth est égale à 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 de 2 h 00 et que BITS consiste à réessayer le travail à 2 h 10, le déplacement de l’horloge système vers l’avant dix minutes ou plus ne signifie pas que BITS retentera le travail au début du travail ; BITS réessayera toujours le travail en dix minutes. Pour refléter la modification de l’horloge système en BITS, vous devez redémarrer l’ordinateur ou le service BITS.

Spécifications

Voir aussi

IBackgroundCopyJob ::GetMinimumRetryDelay

IBackgroundCopyJob ::GetNoProgressTimeout

IBackgroundCopyJob ::SetNoProgressTimeout