Compartir a través de

Método IBackgroundCopyJob::SetMinimumRetryDelay (bits.h)

  • Artículo

Establece el período mínimo de tiempo que BITS espera después de encontrar una condición de error transitorio antes de intentar transferir el archivo.

Sintaxis

HRESULT SetMinimumRetryDelay(
  [in] ULONG Seconds
);

Parámetros

[in] Seconds

Tiempo mínimo, en segundos, que BITS espera después de encontrar un error transitorio antes de intentar transferir el archivo. El retraso de reintento predeterminado es de 600 segundos (10 minutos). El retraso de reintento mínimo que puede especificar es de 5 segundos. Si especifica un valor inferior a 5 segundos, BITS cambia el valor a 5 segundos. Si el valor supera el valor no-progress-timeout recuperado del método GetNoProgressTimeout , BITS no reintentará la transferencia y moverá el trabajo al estado BG_JOB_STATE_ERROR.

Valor devuelto

Este método devuelve los siguientes valores HRESULT , así como otros.

Código devuelto Descripción
S_OK
 Se estableció correctamente el retraso de reintento.
BG_E_INVALID_STATE
 El estado del trabajo no puede ser BG_JOB_STATE_CANCELLED ni BG_JOB_STATE_ACKNOWLEDGED.

Comentarios

Para iniciar el trabajo antes de que expire el período de reintento mínimo, llame al método IBackgroundCopyJob::Resume .

BITS no vuelve a intentar el trabajo si se produjo un error de desconexión de red o bloqueo de disco (por ejemplo, chkdsk en ejecución) o el directiva de grupo MaxInternetBandwidth es cero.

Nota Cambiar el reloj del sistema no afecta al retraso de reintento mínimo. Por ejemplo, si la hora actual es de 2:00 p.m. y BITS es reintentar el trabajo a las 2:10 p.m., mover el reloj del sistema hacia delante diez o más minutos no significa que BITS vuelva a intentar el trabajo antes, BITS seguirá reintentando el trabajo en diez minutos. Para reflejar el cambio del reloj del sistema en BITS, debe reiniciar el equipo o el servicio BITS.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP
Servidor mínimo compatible Windows Server 2003
Plataforma de destino Windows
Encabezado bits.h
Library Bits.lib
Archivo DLL QmgrPrxy.dll

Consulte también

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout