Freigeben über


IBackgroundCopyJob4::SetMaximumDownloadTime-Methode (bits3_0.h)

Legt die maximale Zeit fest, die BITS für die Übertragung der Dateien im Auftrag aufwendet.

Syntax

HRESULT SetMaximumDownloadTime(
  [in] ULONG Timeout
);

Parameter

[in] Timeout

Maximale Zeit in Sekunden, die BITS für die Übertragung der Dateien im Auftrag aufwendet. Der Standardwert ist 7.776.000 Sekunden (90 Tage).

Rückgabewert

Die -Methode gibt die folgenden Rückgabewerte zurück.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg

Hinweise

Der Wert ist die maximale verstrichene Zeit, die der Auftrag im Zustand VERBINDEN oder ÜBERTRAGEN verbringen kann. Die Zeit, die im Status "QUEUED" oder "TRANSIENT_ERROR" verbracht wird, wird nicht auf den Timeoutwert angerechnet. Der Auftrag wechselt in den Zustand schwerwiegender Fehler mit dem Fehlercode BG_E_MAXDOWNLOAD_TIMEOUT, wenn die Übertragungszeit den Timeoutwert überschreitet.

Beachten Sie, dass die Ruhezeit des Computers beim Übertragen der Auftragsdaten durch BITS auf das Timeout angerechnet wird, obwohl die Daten nicht übertragen werden.

Beim Aufrufen der IBackgroundCopyJob::Resume-Methode wird die verstrichene Zeit zurückgesetzt.

Diese Methode setzt die MaxDownloadTime-Gruppenrichtlinie außer Kraft.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile bits3_0.h (bits.h einschließen)
Bibliothek Bits.lib

Weitere Informationen

IBackgroundCopyJob4

IBackgroundCopyJob4::GetMaximumDownloadTime