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 |
---|---|
|
O atraso de repetição foi definido com êxito. |
|
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