Condividi tramite

Enumerazione DODownloadProperty (deliveryoptimization.h)

  • Articolo

L'enumerazione DODownloadProperty specifica l'ID delle proprietà per l'operazione di download di Ottimizzazione recapito. Questa enumerazione viene utilizzata dall'interfaccia IDODownload ed eseguita da un valore VARIANT, in cui è contenuto il tipo di valore.

Sintassi

typedef enum _DODownloadProperty {
  DODownloadProperty_Id,
  DODownloadProperty_Uri,
  DODownloadProperty_ContentId,
  DODownloadProperty_DisplayName,
  DODownloadProperty_LocalPath,
  DODownloadProperty_HttpCustomHeaders,
  DODownloadProperty_CostPolicy,
  DODownloadProperty_SecurityFlags,
  DODownloadProperty_CallbackFreqPercent,
  DODownloadProperty_CallbackFreqSeconds,
  DODownloadProperty_NoProgressTimeoutSeconds,
  DODownloadProperty_ForegroundPriority,
  DODownloadProperty_BlockingMode,
  DODownloadProperty_CallbackInterface,
  DODownloadProperty_StreamInterface,
  DODownloadProperty_SecurityContext,
  DODownloadProperty_NetworkToken,
  DODownloadProperty_CorrelationVector,
  DODownloadProperty_DecryptionInfo,
  DODownloadProperty_IntegrityCheckInfo,
  DODownloadProperty_IntegrityCheckMandatory,
  DODownloadProperty_TotalSizeBytes,
  DODownloadProperty_DisallowOnCellular,
  DODownloadProperty_HttpCustomAuthHeaders,
  DODownloadProperty_HttpAllowSecureToNonSecureRedirect,
  DODownloadProperty_NonVolatile,
  DODownloadProperty_HttpRedirectionTarget,
  DODownloadProperty_HttpResponseHeaders,
  DODownloadProperty_HttpServerIPAddress,
  DODownloadProperty_HttpStatusCode
} DODownloadProperty;

Costanti

 
DODownloadProperty_Id
Di sola lettura. Utilizzare questa proprietà per ottenere l'ID che identifica in modo univoco il download. Il tipo VARIANT è VT_BSTR.
DODownloadProperty_Uri
Utilizzare questa proprietà per impostare o ottenere il percorso URI remoto della risorsa da scaricare. Questa proprietà è obbligatoria solo se non viene specificata DODownloadProperty_ContentId . Il tipo VARIANT è VT_BSTR.
DODownloadProperty_ContentId
Utilizzare questa proprietà per impostare o ottenere l'ID contenuto univoco di download. Questa proprietà è obbligatoria solo se non viene specificata DODownloadProperty_Uri . Il tipo VARIANT è VT_BSTR.
DODownloadProperty_DisplayName
Facoltativa. Utilizzare questa proprietà per impostare o ottenere il nome visualizzato del download. Il tipo VARIANT è VT_BSTR.
DODownloadProperty_LocalPath
Utilizzare questa proprietà per impostare o ottenere il nome del percorso locale per salvare il file di download. Se il percorso non esiste, Ottimizzazione recapito tenterà di crearlo con i privilegi del chiamante. Questa proprietà è obbligatoria solo se non è stato specificato DODownloadProperty_StreamInterface . Il tipo VARIANT è VT_BSTR.
DODownloadProperty_HttpCustomHeaders
Facoltativa. Utilizzare questa proprietà per impostare o ottenere intestazioni di richiesta HTTP personalizzate. Ottimizzazione recapito includerà queste intestazioni durante le operazioni di richiesta di file HTTP. Le intestazioni devono essere già formattate come intestazioni HTTP standard. Il tipo VARIANT è VT_BSTR.
DODownloadProperty_CostPolicy
Facoltativa. Utilizzare questa proprietà per impostare o ottenere uno dei valori di enumerazione DODownloadCostPolicy . Il tipo VARIANT è VT_UI4.
DODownloadProperty_SecurityFlags
Solo scrittura facoltativa. Usare questa proprietà per impostare o ottenere i flag di sicurezza WinHTTP standard (WINHTTP_OPTION_SECURITY_FLAGS). Il tipo VARIANT è VT_UI4.

Sono supportati i flag seguenti:

* SECURITY_FLAG_IGNORE_CERT_CN_INVALID. Consente un nome comune non valido in un certificato.
* SECURITY_FLAG_IGNORE_CERT_DATE_INVALID. Consente una data del certificato non valida.
* SECURITY_FLAG_IGNORE_UNKNOWN_CA. Consente un'autorità di certificazione non valida.
* SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE. Consente di stabilire l'identità di un server con un certificato non server.
* WINHTTP_ENABLE_SSL_REVOCATION. Consente la revoca SSL. Se questo flag è impostato, i flag precedenti verranno ignorati.
DODownloadProperty_CallbackFreqPercent
Facoltativa. Utilizzare questa proprietà per impostare o ottenere la frequenza di callback in base alla percentuale di download. Il tipo VARIANT è VT_UI4.
DODownloadProperty_CallbackFreqSeconds
Facoltativa. Utilizzare questa proprietà per impostare o ottenere la frequenza di callback in base all'ora di download. Il valore predefinito è ogni secondo. Il tipo VARIANT è VT_UI4.
DODownloadProperty_NoProgressTimeoutSeconds
Facoltativa. Utilizzare questa proprietà per impostare o ottenere la lunghezza del timeout del download per nessun avanzamento. Il valore minimo accettato è 60 secondi di nessuna attività di download. Il tipo VARIANT è VT_UI4.
DODownloadProperty_ForegroundPriority
Facoltativa. Utilizzare questa proprietà per impostare o ottenere la priorità di download corrente. VARIANT_TRUE valore porterà il download in primo piano con priorità più alta. Il valore predefinito è priorità in background. Il tipo VARIANT è VT_BOOL.
DODownloadProperty_BlockingMode
Facoltativa. Utilizzare questa proprietà per impostare o ottenere la modalità di blocco del download corrente. VARIANT_TRUE valore causerà il blocco di IDODownload::Start fino al completamento del download o all'errore. Il valore predefinito è la modalità non bloccante. Il tipo VARIANT è VT_BOOL.
DODownloadProperty_CallbackInterface
Facoltativa. Utilizzare questa proprietà per impostare o ottenere il puntatore all'interfaccia IDODownloadStatusCallback usata per scaricare i callback. Il tipo VARIANT è VT_UNKNOWN.
DODownloadProperty_StreamInterface
Facoltativa. Utilizzare questa proprietà per impostare o ottenere il puntatore all'interfaccia IStream usata per il tipo di download del flusso. Il tipo VARIANT è VT_UNKNOWN.
DODownloadProperty_SecurityContext
Solo scrittura facoltativa. Utilizzare questa proprietà per impostare il contesto del certificato da usare durante le operazioni di richiesta HTTP. Il valore deve essere costituito da byte serializzati di CERT_CONTEXT. Il tipo VARIANT è (VT_ARRAY | VT_UI1).
DODownloadProperty_NetworkToken
Solo scrittura facoltativa. Utilizzare questa proprietà per impostare il token di rete da usare durante le operazioni HTTP. VARIANT_TRUE valore causerà l'acquisizione del token di identità del chiamante da parte di Ottimizzazione recapito e VARIANT_FALSE cancella il token esistente. Il valore predefinito è il token dell'utente connesso. Il tipo VARIANT è VT_BOOL.
DODownloadProperty_CorrelationVector
Facoltativa. Imposta un vettore di correlazione specifico per scopi di telemetria. Il tipo VARIANT è VT_BSTR.
DODownloadProperty_DecryptionInfo
Solo scrittura facoltativa. Imposta le informazioni di decrittografia sotto forma di stringa JSON. Il tipo VARIANT è VT_BSTR.
DODownloadProperty_IntegrityCheckInfo
Solo scrittura facoltativa. Imposta il percorso PHF (Piece Hash File), che viene usato da Ottimizzazione recapito per eseguire controlli di integrità del runtime sul contenuto scaricato. Il tipo VARIANT è VT_BSTR.
DODownloadProperty_IntegrityCheckMandatory
Facoltativa. Imposta un flag booleano che indica se l'utilizzo del file hash a fasi (PHF) è obbligatorio. Se VARIANT_TRUE, il download verrà interrotto se il controllo di integrità non riesce. Il tipo VARIANT è VT_BOOL.
DODownloadProperty_TotalSizeBytes
Facoltativa. Specifica le dimensioni totali di download in byte. Il tipo VARIANT è VT_UI8.
DODownloadProperty_DisallowOnCellular
Non scaricare quando si usa una connessione cellulare.
DODownloadProperty_HttpCustomAuthHeaders
Le intestazioni HTTPS personalizzate vengono usate in caso di richiesta.
DODownloadProperty_HttpAllowSecureToNonSecureRedirect
Reindirizzamento https-to-http. Il valore predefinito è FALSE.
DODownloadProperty_NonVolatile
Salvare le informazioni di download nel Registro di sistema di Windows. Il valore predefinito è FALSE per i processi di download dell'ottimizzazione recapito. TRUE Per i processi in stile BITS.

Requisiti

   
Client minimo supportato Windows 11 Build 22621
Intestazione deliveryoptimization.h