Partager via


IBackgroundCopyJob4 ::SetMaximumDownloadTime, méthode (bits3_0.h)

Définit la durée maximale que BITS consacre au transfert des fichiers dans le travail.

Syntaxe

HRESULT SetMaximumDownloadTime(
  [in] ULONG Timeout
);

Paramètres

[in] Timeout

Durée maximale, en secondes, que BITS consacre au transfert des fichiers dans le travail. La valeur par défaut est 7 776 000 secondes (90 jours).

Valeur retournée

La méthode retourne les valeurs de retour suivantes.

Code de retour Description
S_OK
Succès

Remarques

La valeur est le temps maximal écoulé que le travail peut passer à l’état CONNEXION ou TRANSFERT. Le temps passé dans l’état QUEUED ou TRANSIENT_ERROR n’est pas comptabilisé dans la valeur du délai d’expiration. Le travail passe à l’état d’erreur irrécupérable avec un code d’erreur de BG_E_MAXDOWNLOAD_TIMEOUT si le temps de transfert dépasse la valeur du délai d’expiration.

Notez que si l’ordinateur est en veille pendant que BITS transfère les données du travail, le temps passé en veille est comptabilisé par rapport au délai d’expiration même si les données ne sont pas transférées.

L’appel de la méthode IBackgroundCopyJob ::Resume réinitialise le temps écoulé.

Cette méthode remplace la stratégie de groupe MaxDownloadTime.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête bits3_0.h (include Bits.h)
Bibliothèque Bits.lib

Voir aussi

IBackgroundCopyJob4

IBackgroundCopyJob4 ::GetMaximumDownloadTime