IBackgroundCopyJob ::SetMinimumRetryDelay, méthode (bits.h)

  • Article

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
S_OK
 Le délai de nouvelle tentative a été correctement défini.
BG_E_INVALID_STATE
 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

IBackgroundCopyJob ::GetNoProgressTimeout

IBackgroundCopyJob ::SetNoProgressTimeout