Metodo IBackgroundCopyJob::SetNoProgressTimeout (bits.h)

Imposta l'intervallo di tempo in cui BITS tenta di trasferire il file dopo che si verifica una condizione di errore temporanea. In caso di avanzamento, il timer viene reimpostato.

Sintassi

HRESULT SetNoProgressTimeout(
  [in] ULONG Seconds
);

Parametri

[in] Seconds

Intervallo di tempo, in secondi, che BITS tenta di trasferire il file dopo il primo errore temporaneo. Il periodo di ripetizione dei tentativi predefinito è 1.209.600 secondi (14 giorni). Impostare il periodo di ripetizione dei tentativi su 0 per evitare nuovi tentativi e forzare il processo nello stato BG_JOB_STATE_ERROR per tutti gli errori. Se il valore del periodo di ripetizione dei tentativi supera il valore di Criteri di gruppo JobInactivityTimeout (valore predefinito di 90 giorni), BITS annulla il processo dopo il superamento del valore del criterio.

Valore restituito

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

Osservazioni:

Se BITS non apporta progressi durante il periodo di ripetizione dei tentativi, sposta lo stato del processo da BG_JOB_STATE_TRANSIENT_ERROR a BG_JOB_STATE_ERROR. Se si richiede una notifica di errore, BITS chiama il callback jobError .

Nota La modifica dell'orologio di sistema non influisce sul periodo di ripetizione dei tentativi. Ad esempio, se il periodo di ripetizione dei tentativi scade in 14 giorni, lo spostamento dell'orologio di sistema in avanti di 14 o più giorni non significa che il periodo di ripetizione dei tentativi scade in anticipo, il periodo di ripetizione dei tentativi scadrà comunque in 14 giorni. Per riflettere la modifica dell'orologio di sistema in BITS, è necessario riavviare il computer o il servizio BITS.

Requisiti

Vedere anche

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetMinimumRetryDelay