Metodo IBackgroundCopyFile6::GetFilledFileRanges (bits10_1.h)
Restituisce il set di intervalli di file scaricati.
Sintassi
HRESULT GetFilledFileRanges(
[out] DWORD *rangeCount,
[out] BG_FILE_RANGE **ranges
);
Parametri
[out] rangeCount
Numero di elementi in Intervalli.
[out] ranges
Matrice di strutture BG_FILE_RANGE che descrivono gli intervalli scaricati. Gli intervalli verranno uniti il più possibile. Gli intervalli vengono ordinati in base all'offset. Al termine, chiamare la funzione CoTaskMemFree per liberare Intervalli.
Valore restituito
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . L'errore verrà E_OUTOFMEMORY se non è stato possibile allocare la matrice Di intervalli e BG_E_RANDOM_ACCESS_NOT_SUPPORTED se il processo non è un processo di download o se il server perde la possibilità di supportare gli intervalli di download.
Commenti
GetFilledFileRanges 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 di 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.
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 (includere Bits.h) |
Libreria | Bits.lib |