IBackgroundCopyJob::SetNoProgressTimeout-Methode (bits.h)
Legt die Dauer fest, für die BITS versucht, die Datei zu übertragen, nachdem ein vorübergehender Fehler auftritt. Wenn ein Fortschritt vorhanden ist, wird der Timer zurückgesetzt.
Syntax
HRESULT SetNoProgressTimeout(
[in] ULONG Seconds
);
Parameter
[in] Seconds
Dauer in Sekunden, in der BITS versucht, die Datei zu übertragen, nachdem der erste vorübergehende Fehler aufgetreten ist. Der Standardmäßige Wiederholungszeitraum beträgt 1.209.600 Sekunden (14 Tage). Legen Sie den Wiederholungszeitraum auf 0 fest, um Wiederholungen zu verhindern und den Auftrag in den BG_JOB_STATE_ERROR Zustand für alle Fehler zu erzwingen. Wenn der Wert für den Wiederholungszeitraum den Wert von JobInactivityTimeout Gruppenrichtlinie (Standardwert von 90 Tagen) überschreitet, bricht BITS den Auftrag ab, nachdem der Richtlinienwert überschritten wurde.
Rückgabewert
Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Wiederholungszeitraum erfolgreich festgelegt. |
|
Der Status des Auftrags kann nicht BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED werden. |
Hinweise
Wenn BITS während des Wiederholungszeitraums keinen Fortschritt macht, wird der Status des Auftrags von BG_JOB_STATE_TRANSIENT_ERROR in BG_JOB_STATE_ERROR verschoben. Wenn Sie eine Fehlerbenachrichtigung anfordern, ruft BITS ihren JobError-Rückruf auf.
Hinweis Das Ändern der Systemuhr wirkt sich nicht auf den Wiederholungszeitraum aus. Wenn der Wiederholungszeitraum beispielsweise in 14 Tagen abläuft, bedeutet das Verschieben der Systemuhr um 14 oder mehr Tage nicht, dass der Wiederholungszeitraum vorzeitig abläuft– der Wiederholungszeitraum läuft weiterhin in 14 Tagen ab. 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 |