IBackgroundCopyJob::SetNoProgressTimeout-Methode (Bits.h)
Legt die Dauer fest, in der BITS versucht, die Datei zu übertragen, nachdem eine vorübergehende Fehlerbedingung auftritt. Wenn der Fortschritt vorhanden ist, wird der Zeitgeber zurückgesetzt.
Syntax
HRESULT SetNoProgressTimeout(
[in] ULONG Seconds
);
Parameter
[in] Seconds
Länge der Zeit, in Sekunden, die BITS versucht, die Datei zu übertragen, nachdem der erste vorübergehende Fehler auftritt. 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 Wiederholungszeitraumswert den JobInactivityTimeout Gruppenrichtlinie Wert überschreitet (Standardeinstellung von 90 Tagen), wird bitS den Auftrag abgebrochen, nachdem der Richtlinienwert überschritten wurde.
Rückgabewert
Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Wiederholen Sie den Vorgangszeitraum erfolgreich. |
|
Der Status des Auftrags kann nicht BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED sein. |
Bemerkungen
Wenn BITS während des Wiederholungszeitraums keinen Fortschritt macht, wird der Status des Auftrags von BG_JOB_STATE_TRANSIENT_ERROR auf BG_JOB_STATE_ERROR verschoben. Wenn Sie fehlermeldungsbenachrichtigung anfordern, ruft BITS dann ihren JobError-Rückruf auf.
Hinweis Das Ändern der Systemuhr wirkt sich nicht auf den Wiederholungszeitraum aus. Wenn z. B. der Wiederholungszeitraum in 14 Tagen abläuft, bedeutet das Verschieben der Systemuhr 14 oder mehr Tage nicht, dass der Wiederholungszeitraum früh abläuft – der Wiederholungszeitraum läuft immer noch in 14 Tagen ab. Um die Systemuhränderung in BITS widerzuspiegeln, müssen Sie den Computer oder den BITS-Dienst neu starten.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Zielplattform | Windows |
| Kopfzeile | bits.h |
| Bibliothek | Bits.lib |
| DLL | QmgrPrxy.dll |