Share via

enumerazione BITS_JOB_PROPERTY_ID (bits5_0.h)

  • Articolo

Definisce le costanti che specificano l'ID della proprietà per il processo BITS.

Questa enumerazione viene usata nell'unione BITS_JOB_PROPERTY_VALUE per determinare il tipo di valore contenuto nell'unione.

Sintassi

typedef enum BITS_JOB_PROPERTY_ID {
  BITS_JOB_PROPERTY_ID_COST_FLAGS = 1,
  BITS_JOB_PROPERTY_NOTIFICATION_CLSID = 2,
  BITS_JOB_PROPERTY_DYNAMIC_CONTENT = 3,
  BITS_JOB_PROPERTY_HIGH_PERFORMANCE = 4,
  BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE = 5,
  BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS = 7,
  BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS = 9,
  BITS_JOB_PROPERTY_ON_DEMAND_MODE = 10
} ;

Costanti

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
Valore: 1
ID usato per controllare il comportamento di trasferimento su reti cellulari e/o simili. Questa proprietà può essere modificata mentre un trasferimento è in corso: i nuovi flag di costo avranno effetto immediatamente.

Questa proprietà usa il campo DWORD del BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
Valore: 2
ID usato per registrare un callback COM da CLSID per ricevere notifiche sullo stato di avanzamento e sul completamento di un processo BITS. CLSID deve fare riferimento a una classe associata a un server COM registrato. Può anche essere impostato su GUID_NULL per cancellare un CLSID di notifica impostato in precedenza.

Questa proprietà usa il campo CLsID del BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
Valore: 3
ID per contrassegnare un processo BITS come disposto a scaricare il contenuto che non supporta i normali requisiti HTTP per i download BITS: richieste HEAD, intestazione Content-Length e intestazione Content-Range. Il download di questo tipo di contenuto è esplicito, perché BITS non può sospendere e riprendere i processi di download senza tale supporto. Se un processo con questa proprietà abilitata viene interrotto per qualsiasi motivo, ad esempio una perdita temporanea della connettività di rete o il riavvio del sistema, BITS riavvierà il download dall'inizio anziché riprendere la posizione in cui è stata interrotta. BITS non può anche limitare l'utilizzo della larghezza di banda per i download dinamici; BITS non eseguirà trasferimenti senza errori per qualsiasi processo che non dispone di BG_JOB_PRIORITY_FOREGROUND assegnato, pertanto è consigliabile impostare in genere tale priorità ogni volta che si usa un processo per consentire il contenuto dinamico.

Questa proprietà usa il campo Enable del BITS_JOB_PROPERTY_VALUE. Questa proprietà è supportata solo per i processi di BG_JOB_TYPE_DOWNLOAD . Non è supportato per i download che usano FILE_RANGES. Questa proprietà può essere impostata solo prima della prima chiamata a Resume in un processo.
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
Valore: 4
ID per contrassegnare un processo BITS come non richiedere garanzie di affidabilità forti. L'abilitazione di questa proprietà causerà l'evitare che BITS eviti di mantenere le informazioni sullo stato di avanzamento normale del processo, che in genere BITS esegue periodicamente. In caso di arresto imprevisto, ad esempio una perdita di energia, durante un trasferimento, questo causerà la perdita dello stato di avanzamento di BITS

e riavviare il processo dall'inizio invece di riprendere da dove è stato interrotto come di consueto. Tuttavia, ridurrà anche il numero di operazioni bitS di scrittura del disco nel corso della durata di un processo, che può migliorare le prestazioni per i processi più piccoli.

Questa proprietà causa anche il download di BITS direttamente nel file di destinazione, anziché il download in un file temporaneo e lo spostamento del file temporaneo nella destinazione finale al termine del trasferimento. Ciò significa che BITS non pulisce alcun contenuto parzialmente scaricato se un processo viene annullato o rileva una condizione di errore irreversibile; il chiamante BITS è responsabile della pulizia del file di destinazione, se viene creato. Tuttavia, ridurrà leggermente il sovraccarico del disco.

Questa proprietà è consigliata solo per scenari che prevedono un numero elevato di processi di piccole dimensioni (sotto 1 MB) e che non richiedono affidabilità per la perdita di energia o altri eventi di arresto imprevisti. I risparmi sulle prestazioni non sono in genere significativi per il numero ridotto di posti di lavoro o per i posti di lavoro più grandi.

Questa proprietà usa il campo Enable del BITS_JOB_PROPERTY_VALUE. Questa proprietà è supportata solo per i processi di BG_JOB_TYPE_DOWNLOAD . Questa proprietà può essere impostata solo prima di aggiungere file a un processo.
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
Valore: 5
L'ID per contrassegnare il numero massimo di byte di un processo BITS sarà consentito per il download totale. Questa proprietà è destinata all'uso con BITS_JOB_PROPERTY_DYNAMIC_CONTENT, in cui potrebbe non essere possibile determinare le dimensioni del file da scaricare in anticipo, ma si vuole limitare le dimensioni totali del download.

Questa proprietà usa il campo Enable del BITS_JOB_PROPERTY_VALUE. Questa proprietà è supportata solo per i processi di BG_JOB_TYPE_DOWNLOAD . Questa proprietà può essere impostata solo prima della prima chiamata a Resume in un processo.
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
Valore: 7
ID per contrassegnare un processo BITS come disposto a includere le credenziali predefinite nelle richieste ai server proxy. L'abilitazione di questa proprietà equivale a impostare un livello di sicurezza WinHTTP di WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM sulle richieste eseguite da BITS per conto dell'utente. L'utente BITS recupera le credenziali archiviate dall'oggetto è uguale a quello che effettua le richieste di rete per conto di: BITS userà normalmente le credenziali del proprietario del processo, a meno che non sia stato fornito in modo esplicito un token helper di rete, in cui BITS userà le credenziali del token dell'helper di rete.

Questa proprietà usa il campo Target del BITS_JOB_PROPERTY_VALUE. Tuttavia, solo la destinazione BG_AUTH_TARGET_PROXY è supportata.
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
Valore: 9
ID usato per controllare la tempistica delle notifiche BITS JobNotification e FileRangesTransferred . L'abilitazione di questa proprietà consente a un utente di ricevere una notifica a una frequenza diversa. Questa proprietà può essere modificata mentre è in corso un trasferimento; tuttavia, la nuova tariffa potrebbe non essere applicata immediatamente. Il valore predefinito è 500 millisecondi.

Questa proprietà usa il campo DWORD del BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_ON_DEMAND_MODE
Valore: 10
ID usato per controllare se un processo è in modalità On Demand. I processi On Demand consentono all'app di richiedere intervalli specifici per un download di file anziché scaricare dall'inizio alla fine. Il valore predefinito è FALSE; il processo non è su richiesta. Gli intervalli vengono richiesti usando il metodo IBackgroundCopyFile6::RequestFileRanges .

Questa proprietà usa il campo Enable del BITS_JOB_PROPERTY_VALUE.

I requisiti per un processo BITS_JOB_PROPERTY_ON_DEMAND_MODE è che il trasferimento deve essere un processo BG_JOB_TYPE_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.

Requisiti

Requisito Valore
Client minimo supportato Windows 8
Server minimo supportato Windows Server 2012
Intestazione bits5_0.h

Vedi anche