Compartilhar via


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

Define o período mínimo de tempo que o BITS aguarda depois de encontrar uma condição de erro transitória antes de tentar transferir o arquivo.

Sintaxe

HRESULT SetMinimumRetryDelay(
  [in] ULONG Seconds
);

Parâmetros

[in] Seconds

Período mínimo de tempo, em segundos, que o BITS aguarda após encontrar um erro transitório antes de tentar transferir o arquivo. O atraso de repetição padrão é de 600 segundos (10 minutos). O atraso mínimo de repetição que você pode especificar é de 5 segundos. Se você especificar um valor inferior a 5 segundos, o BITS alterará o valor para 5 segundos. Se o valor exceder o valor de tempo limite sem progresso recuperado do método GetNoProgressTimeout , o BITS não tentará novamente a transferência e moverá o trabalho para o estado BG_JOB_STATE_ERROR.

Retornar valor

Esse método retorna os seguintes valores HRESULT , bem como outros.

Código de retorno Descrição
S_OK
O atraso de repetição foi definido com êxito.
BG_E_INVALID_STATE
O estado do trabalho não pode ser BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED.

Comentários

Para iniciar o trabalho antes que o período mínimo de repetição expire, chame o método IBackgroundCopyJob::Resume .

O BITS não tentará novamente o trabalho se ocorrer um erro de desconexão de rede ou bloqueio de disco (por exemplo, chkdsk está em execução) ou o Política de Grupo MaxInternetBandwidth for zero.

Nota Alterar o relógio do sistema não afeta o atraso mínimo de repetição. Por exemplo, se a hora atual for 14:00 e o BITS tentar novamente o trabalho às 14h10, mover o relógio do sistema para frente dez ou mais minutos não significa que o BITS repetirá o trabalho mais cedo— o BITS ainda tentará o trabalho novamente em dez minutos. Para refletir a alteração do relógio do sistema no BITS, você deve reiniciar o computador ou o serviço BITS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Plataforma de Destino Windows
Cabeçalho bits.h
Biblioteca Bits.lib
DLL QmgrPrxy.dll

Confira também

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout