Compartilhar via


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

Define o período de tempo que o BITS tenta transferir o arquivo depois que ocorre uma condição de erro transitória. Se houver progresso, o temporizador será redefinido.

Sintaxe

HRESULT SetNoProgressTimeout(
  [in] ULONG Seconds
);

Parâmetros

[in] Seconds

Durante o tempo, em segundos, esse BITS tenta transferir o arquivo após o primeiro erro transitório. O período de repetição padrão é de 1.209.600 segundos (14 dias). Defina o período de repetição como 0 para evitar novas tentativas e para forçar o trabalho no estado BG_JOB_STATE_ERROR para todos os erros. Se o valor do período de repetição exceder o valor de Política de Grupo JobInactivityTimeout (padrão de 90 dias), o BITS cancelará o trabalho depois que o valor da política for excedido.

Retornar valor

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

Código de retorno Descrição
S_OK
Período de repetição 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

Se o BITS não fizer progresso durante o período de repetição, ele moverá o estado do trabalho de BG_JOB_STATE_TRANSIENT_ERROR para BG_JOB_STATE_ERROR. Se você solicitar notificação de erro, o BITS chamará o retorno de chamada jobError .

Nota Alterar o relógio do sistema não afeta o período de repetição. Por exemplo, se o período de repetição expirar em 14 dias, mover o relógio do sistema para frente 14 ou mais dias não significa que o período de repetição expira antecipadamente— o período de repetição ainda expirará em 14 dias. Para refletir a alteração do relógio do sistema em 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::GetNoProgressTimeout

IBackgroundCopyJob::SetMinimumRetryDelay