Share via

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

  • Article

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
S_OK
 La période de nouvelle tentative a été correctement définie.
BG_E_INVALID_STATE
 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

Voir aussi

IBackgroundCopyJob ::GetNoProgressTimeout

IBackgroundCopyJob ::SetMinimumRetryDelay