Metodo IBackgroundCopyJob::SetNoProgressTimeout (bits.h)

Articolo
08/22/2023

Imposta il periodo 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

Tempo di tempo, in secondi, che BITS tenta di trasferire il file dopo che si verifica 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 tentativi e forzare il processo nello stato di BG_JOB_STATE_ERROR per tutti gli errori. Se il valore del periodo di ripetizione dei tentativi supera il valore JobInactivityTimeout Criteri di gruppo (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.

Codice restituito	Descrizione
S_OK	Periodo di ripetizione dei tentativi impostato correttamente.
BG_E_INVALID_STATE	Lo stato del processo non può essere BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED.

Commenti

Se BITS non effettua 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 di 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 14 o più giorni non significa che il periodo di ripetizione dei tentativi scade in anticipo, il periodo di ripetizione dei tentativi scade comunque in 14 giorni. 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::GetNoProgressTimeout

IBackgroundCopyJob::SetMinimumRetryDelay

Share via