Compartir a través de

Enumeración DODownloadProperty (deliveryoptimization.h)

  • Artículo

La enumeración DODownloadProperty especifica el identificador de las propiedades para la operación de descarga de optimización de distribución. Esta enumeración la usa la interfaz IDODownload y la lleva a cabo un valor VARIANT, donde se incluye el tipo de valor.

Syntax

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;

Constantes

 
DODownloadProperty_Id
Solo lectura. Utilice esta propiedad para obtener el identificador que identifica de forma única la descarga. El tipo VARIANT es VT_BSTR.
DODownloadProperty_Uri
Use esta propiedad para establecer o obtener la ruta de acceso del URI remoto del recurso que se va a descargar. Esta propiedad solo es necesaria si no se proporciona DODownloadProperty_ContentId . El tipo VARIANT es VT_BSTR.
DODownloadProperty_ContentId
Use esta propiedad para establecer u obtener el identificador de contenido único de descarga. Esta propiedad solo es necesaria si no se proporciona DODownloadProperty_Uri . El tipo VARIANT es VT_BSTR.
DODownloadProperty_DisplayName
Opcional. Use esta propiedad para establecer u obtener el nombre para mostrar de descarga. El tipo VARIANT es VT_BSTR.
DODownloadProperty_LocalPath
Use esta propiedad para establecer o obtener el nombre de la ruta de acceso local para guardar el archivo de descarga. Si la ruta de acceso no existe, Optimización de distribución intentará crearla bajo los privilegios del autor de la llamada. Esta propiedad solo es necesaria si no se proporcionó DODownloadProperty_StreamInterface . El tipo VARIANT es VT_BSTR.
DODownloadProperty_HttpCustomHeaders
Opcional. Use esta propiedad para establecer u obtener encabezados de solicitud HTTP personalizados. Optimización de distribución incluirá estos encabezados durante las operaciones de solicitud de archivos HTTP. Los encabezados ya deben tener el formato de encabezados HTTP estándar. El tipo VARIANT es VT_BSTR.
DODownloadProperty_CostPolicy
Opcional. Utilice esta propiedad para establecer u obtener uno de los valores de enumeración DODownloadCostPolicy . El tipo VARIANT es VT_UI4.
DODownloadProperty_SecurityFlags
Solo escritura opcional. Use esta propiedad para establecer u obtener las marcas de seguridad WinHTTP estándar (WINHTTP_OPTION_SECURITY_FLAGS). El tipo VARIANT es VT_UI4.

Se admiten las marcas siguientes:

* SECURITY_FLAG_IGNORE_CERT_CN_INVALID. Permite un nombre común no válido en un certificado.
* SECURITY_FLAG_IGNORE_CERT_DATE_INVALID. Permite una fecha de certificado no válida.
* SECURITY_FLAG_IGNORE_UNKNOWN_CA. Permite una entidad de certificación no válida.
* SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE. Permite establecer la identidad de un servidor con un certificado que no sea de servidor.
* WINHTTP_ENABLE_SSL_REVOCATION. Permite la revocación de SSL. Si se establece esta marca, se omitirán las marcas anteriores.
DODownloadProperty_CallbackFreqPercent
Opcional. Utilice esta propiedad para establecer o obtener la frecuencia de devolución de llamada en función del porcentaje de descarga. El tipo VARIANT es VT_UI4.
DODownloadProperty_CallbackFreqSeconds
Opcional. Utilice esta propiedad para establecer o obtener la frecuencia de devolución de llamada en función del tiempo de descarga. El valor predeterminado es cada segundo. El tipo VARIANT es VT_UI4.
DODownloadProperty_NoProgressTimeoutSeconds
Opcional. Utilice esta propiedad para establecer o obtener la duración del tiempo de espera de descarga sin progreso. El valor mínimo aceptado es de 60 segundos sin actividad de descarga. El tipo VARIANT es VT_UI4.
DODownloadProperty_ForegroundPriority
Opcional. Utilice esta propiedad para establecer o obtener la prioridad de descarga actual. VARIANT_TRUE valor llevará la descarga al primer plano con mayor prioridad. El valor predeterminado es la prioridad en segundo plano. El tipo VARIANT es VT_BOOL.
DODownloadProperty_BlockingMode
Opcional. Utilice esta propiedad para establecer u obtener el modo de bloqueo de descarga actual. VARIANT_TRUE valor hará que IDODownload::Start se bloquee hasta que se complete la descarga o se haya producido un error. El valor predeterminado es el modo de no bloqueo. El tipo VARIANT es VT_BOOL.
DODownloadProperty_CallbackInterface
Opcional. Utilice esta propiedad para establecer o obtener el puntero a la interfaz IDODownloadStatusCallback que se usa para las devoluciones de llamada de descarga. El tipo VARIANT es VT_UNKNOWN.
DODownloadProperty_StreamInterface
Opcional. Use esta propiedad para establecer o obtener el puntero a la interfaz IStream usada para el tipo de descarga de secuencias. El tipo VARIANT es VT_UNKNOWN.
DODownloadProperty_SecurityContext
Solo escritura opcional. Utilice esta propiedad para establecer el contexto de certificado que se usará durante las operaciones de solicitud HTTP. El valor debe constar de bytes serializados de CERT_CONTEXT. El tipo VARIANT es (VT_ARRAY | VT_UI1).
DODownloadProperty_NetworkToken
Solo escritura opcional. Utilice esta propiedad para establecer el token de red que se usará durante las operaciones HTTP. VARIANT_TRUE valor hará que la Optimización de distribución capture el token de identidad del autor de la llamada y VARIANT_FALSE borrará el token existente. El valor predeterminado es el token del usuario que ha iniciado sesión. El tipo VARIANT es VT_BOOL.
DODownloadProperty_CorrelationVector
Opcional. Establece un vector de correlación específico para fines de telemetría. El tipo VARIANT es VT_BSTR.
DODownloadProperty_DecryptionInfo
Solo escritura opcional. Establece información de descifrado en forma de cadena JSON. El tipo VARIANT es VT_BSTR.
DODownloadProperty_IntegrityCheckInfo
Solo escritura opcional. Establece la ubicación del archivo hash de pieza (PHF), que la optimización de distribución usa para realizar comprobaciones de integridad en tiempo de ejecución en el contenido descargado. El tipo VARIANT es VT_BSTR.
DODownloadProperty_IntegrityCheckMandatory
Opcional. Establece una marca booleana que indica si el uso del archivo hash de pieza (PHF) es obligatorio. Si VARIANT_TRUE, se anulará la descarga si se produce un error en la comprobación de integridad. El tipo VARIANT es VT_BOOL.
DODownloadProperty_TotalSizeBytes
Opcional. Especifica el tamaño total de descarga en bytes. El tipo VARIANT es VT_UI8.
DODownloadProperty_DisallowOnCellular
No descargue cuándo se encuentra en una conexión de telefonía móvil.
DODownloadProperty_HttpCustomAuthHeaders
Los encabezados HTTPS personalizados se usan cuando se impugnan.
DODownloadProperty_HttpAllowSecureToNonSecureRedirect
Redireccionamiento https-to-http. El valor predeterminado es FALSE.
DODownloadProperty_NonVolatile
Guarda la información de descarga en el Registro de Windows. El valor predeterminado es FALSE para los trabajos de descarga de Optimización de distribución; TRUE para trabajos de estilo BITS.

Requisitos

   
Cliente mínimo compatible Windows 11 compilación 22621
Encabezado deliveryoptimization.h