IBackgroundCopyJob::SetMinimumRetryDelay-Methode (bits.h)

  • Artikel

Legt die Mindestdauer fest, die BITS nach auftreten einer vorübergehenden Fehlerbedingung wartet, bevor versucht wird, die Datei zu übertragen.

Syntax

HRESULT SetMinimumRetryDelay(
  [in] ULONG Seconds
);

Parameter

[in] Seconds

Mindestdauer in Sekunden, die BITS wartet, nachdem ein vorübergehender Fehler aufgetreten ist, bevor versucht wird, die Datei zu übertragen. Die Standardmäßige Wiederholungsverzögerung beträgt 600 Sekunden (10 Minuten). Die minimale Wiederholungsverzögerung, die Sie angeben können, beträgt 5 Sekunden. Wenn Sie einen Wert kleiner als 5 Sekunden angeben, ändert BITS den Wert in 5 Sekunden. Wenn der Wert den no-progress-timeout-Wert überschreitet, der von der GetNoProgressTimeout-Methode abgerufen wurde, versucht BITS die Übertragung nicht erneut und verschiebt den Auftrag in den BG_JOB_STATE_ERROR Zustand.

Rückgabewert

Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.

Rückgabecode Beschreibung
S_OK
 Die Wiederholungsverzögerung wurde erfolgreich festgelegt.
BG_E_INVALID_STATE
 Der Status des Auftrags kann nicht BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED werden.

Hinweise

Um den Auftrag zu starten, bevor der minimale Wiederholungszeitraum abläuft, rufen Sie die IBackgroundCopyJob::Resume-Methode auf.

BITS wiederholt den Auftrag nicht, wenn ein Fehler bei der Netzwerktrennung oder Datenträgersperre aufgetreten ist (z. B. wird chkdsk ausgeführt) oder die MaxInternetBandwidth-Gruppenrichtlinie null ist.

Hinweis Das Ändern der Systemuhr wirkt sich nicht auf die minimale Wiederholungsverzögerung aus. Wenn z. B. die aktuelle Uhrzeit 14:00 Uhr ist und BITS den Auftrag um 14:10 Uhr wiederholen soll, bedeutet das verschieben der Systemuhr um zehn Oder mehr Minuten nicht, dass BITS den Auftrag frühzeitig wiederholt– BITS versucht den Auftrag weiterhin in zehn Minuten. Um die Änderung der Systemuhr in BITS widerzuspiegeln, müssen Sie den Computer oder den BITS-Dienst neu starten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP
Unterstützte Mindestversion (Server) Windows Server 2003
Zielplattform Windows
Kopfzeile bits.h
Bibliothek Bits.lib
DLL QmgrPrxy.dll

Weitere Informationen

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout