Metodo IBackgroundCopyJob4::SetMaximumDownloadTime (bits3_0.h)

Imposta il tempo massimo di trasferimento dei file nel processo da parte di BITS.

Sintassi

HRESULT SetMaximumDownloadTime(
  [in] ULONG Timeout
);

Parametri

[in] Timeout

Tempo massimo, in secondi, che BITS trascorrerà il trasferimento dei file nel processo. Il valore predefinito è 7.776.000 secondi (90 giorni).

Valore restituito

Il metodo restituisce i valori restituiti seguenti.

Codice restituito Descrizione
S_OK
Operazione riuscita

Commenti

Il valore è il tempo trascorso massimo che il processo può trascorrere nello stato CONNECTING o TRANSFERING. Il tempo impiegato nello stato QUEUED o TRANSIENT_ERROR non viene conteggiato rispetto al valore di timeout. Il processo immette lo stato di errore irreversibile con un codice di errore di BG_E_MAXDOWNLOAD_TIMEOUT se il tempo di trasferimento supera il valore di timeout.

Si noti che se il computer è in sospensione mentre BITS trasferisce i dati del processo, il tempo impiegato per dormire verrà conteggiato rispetto al timeout anche se i dati non vengono trasferiti.

Chiamando il metodo IBackgroundCopyJob::Resume , viene reimpostato il tempo trascorso.

Questo metodo esegue l'override dei criteri di gruppo MaxDownloadTime.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione bits3_0.h (include Bits.h)
Libreria Bits.lib

Vedi anche

IBackgroundCopyJob4

IBackgroundCopyJob4::GetMaximumDownloadTime