IBackgroundCopyJob::SetMinimumRetryDelay-Methode (bits.h)

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.

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

Weitere Informationen

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout