Metodo IBackgroundCopyJob::SetMinimumRetryDelay (bits.h)

Articolo
02/26/2024

Imposta il tempo minimo di attesa di BITS dopo aver rilevato una condizione di errore temporanea prima di provare a trasferire il file.

Sintassi

HRESULT SetMinimumRetryDelay(
  [in] ULONG Seconds
);

Parametri

[in] Seconds

Tempo minimo, in secondi, che BITS attende dopo aver rilevato un errore temporaneo prima di provare a trasferire il file. Il ritardo di ripetizione dei tentativi predefinito è di 600 secondi (10 minuti). Il ritardo minimo dei tentativi che è possibile specificare è di 5 secondi. Se si specifica un valore minore di 5 secondi, BITS modifica il valore su 5 secondi. Se il valore supera il valore no-progress-timeout recuperato dal metodo GetNoProgressTimeout, BITS non ritenta il trasferimento e sposta il processo nello stato di BG_JOB_STATE_ERROR.

Valore restituito

Questo metodo restituisce i valori HRESULT seguenti, nonché altri.

Codice restituito	Descrizione
S_OK	Il ritardo dei tentativi è stato impostato correttamente.
BG_E_INVALID_STATE	Lo stato del processo non può essere BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED.

Commenti

Per avviare il processo prima della scadenza minima del periodo di ripetizione dei tentativi, chiamare il metodo IBackgroundCopyJob::Resume .

BITS non ritenta il processo se si è verificato un errore di disco o disco( ad esempio, chkdsk è in esecuzione) o il Criteri di gruppo MaxInternetBandwidth è zero.

Nota La modifica dell'orologio di sistema non influisce sul ritardo minimo dei tentativi. Ad esempio, se l'ora corrente è 2:00 P.M. e BITS consiste nel riprovare il processo alle 2:10 P.M., spostare l'orologio di sistema avanti dieci o più minuti significa che BITS riprova il processo in anticipo, BITS continuerà a riprovare il processo in dieci minuti. Per riflettere la modifica dell'orologio di sistema in BITS, è necessario riavviare il computer o il servizio BITS.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP
Server minimo supportato	Windows Server 2003
Piattaforma di destinazione	Windows
Intestazione	bits.h
Libreria	Bits.lib
DLL	QmgrPrxy.dll

Vedi anche

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout

Condividi tramite