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.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Wiederholungsverzögerung wurde erfolgreich festgelegt. |
|
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