Método IBackgroundCopyJob4::SetMaximumDownloadTime (bits3_0.h)

  • Artigo

Define o tempo máximo que o BITS gastará transferindo os arquivos no trabalho.

Sintaxe

HRESULT SetMaximumDownloadTime(
  [in] ULONG Timeout
);

Parâmetros

[in] Timeout

Tempo máximo, em segundos, que o BITS gastará transferindo os arquivos no trabalho. O padrão é 7.776.000 segundos (90 dias).

Retornar valor

O método retorna os seguintes valores retornados.

Código de retorno Descrição
S_OK
 Êxito

Comentários

O valor é o tempo máximo decorrido que o trabalho pode gastar no estado CONNECTING ou TRANSFERING. O tempo gasto no estado QUEUED ou TRANSIENT_ERROR não conta com o valor de tempo limite. O trabalho entra no estado de erro fatal com um código de erro de BG_E_MAXDOWNLOAD_TIMEOUT se o tempo de transferência exceder o valor do tempo limite.

Observe que, se o computador estiver dormindo enquanto o BITS estiver transferindo os dados do trabalho, o tempo gasto para dormir contará com o tempo limite, mesmo que os dados não sejam transferidos.

Chamar o método IBackgroundCopyJob::Resume redefine o tempo decorrido.

Esse método substitui a política de grupo MaxDownloadTime.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho bits3_0.h (inclua Bits.h)
Biblioteca Bits.lib

Confira também

IBackgroundCopyJob4

IBackgroundCopyJob4::GetMaximumDownloadTime