IBackgroundCopyJob::SetNoProgressTimeout-Methode (bits.h)

  • Artikel

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
S_OK
 Wiederholungszeitraum erfolgreich festgelegt.
BG_E_INVALID_STATE
 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

Weitere Informationen

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetMinimumRetryDelay