Compartilhar via


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

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

Sintaxe

HRESULT SetMinimumRetryDelay(
  [in] ULONG Seconds
);

Parâmetros

[in] Seconds

Tempo mínimo, 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 menor que 5 segundos, o BITS alterará o valor para 5 segundos. Se o valor exceder o valor sem progresso-tempo limite 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.

Valor de retorno

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

Código de retorno Description
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.

Observações

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 se a Política de Grupo MaxInternetBandwidth é 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 14h00 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 tentará novamente 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.

Requirements

Requirement Value
Cliente mínimo suportado Windows XP
Servidor mínimo compatível Windows Server 2003
da Plataforma de Destino Windows
Header bits.h
Library Bits.lib
de DLL QmgrPrxy.dll

Consulte também

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout