Condividi tramite

Metodo IBackgroundCopyFile6::RequestFileRanges (bits10_1.h)

  • Articolo

Aggiunge un nuovo set di intervalli di file da classificare in ordine di priorità per il download.

Sintassi

HRESULT RequestFileRanges(
  [in] DWORD                  rangeCount,
  [in] const BG_FILE_RANGE [] ranges
);

Parametri

[in] rangeCount

Specifica le dimensioni della matrice Ranges .

[in] ranges

Matrice di intervalli di file da scaricare. Gli intervalli richiesti possono sovrapporsi a intervalli scaricati (o in sospeso) scaricati in precedenza. Gli intervalli vengono suddivisi automaticamente in intervalli non sovrapposti.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . BG_E_INVALID_RANGE viene restituito se una parte dell'intervallo richiesto non rientra nelle dimensioni effettive del file; BG_E_RANDOM_ACCESS_NOT_SUPPORTED viene restituito se il processo non è un processo di download o se il server perde la capacità di supportare gli intervalli di download.

Commenti

RequestFileRanges può essere richiesto per qualsiasi processo di download che soddisfi anche i requisiti per i processi di BITS_JOB_PROPERTY_ON_DEMAND_MODE .

I requisiti per un processo BITS_JOB_PROPERTY_ON_DEMAND_MODE è che il trasferimento deve essere un processo DOWNLOAD . Il processo non deve essere DINAMICO e il server deve essere un server HTTP o HTTPS e i requisiti del server per il supporto dell'intervallo devono essere soddisfatti. Per altre informazioni, vedere Requisiti HTTP per i download BITS.

Quando tutti gli intervalli richiesti sono stati scaricati, lo stato del processo verrà impostato su BG_JOB_STATE_TRANSFERRED se tutti i byte del file sono stati trasferiti. In caso contrario, lo stato del processo verrà impostato su BG_JOB_STATE_SUSPENDED.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 1703 [solo app desktop]
Server minimo supportato Windows Server 2016 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione bits10_1.h (include Bits.h)
Libreria Bits.lib

Vedi anche

IBackgroundCopyFile6