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 |
---|---|
|
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 |