Compartir a través de

enumeración BITS_JOB_PROPERTY_ID (bits5_0.h)

  • Artículo

Define constantes que especifican el identificador de la propiedad para el trabajo de BITS.

Esta enumeración se usa en la unión BITS_JOB_PROPERTY_VALUE para determinar el tipo de valor contenido en la unión.

Syntax

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
} ;

Constantes

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
Valor: 1
Identificador que se usa para controlar el comportamiento de transferencia a través de redes móviles o similares. Esta propiedad puede cambiarse mientras una transferencia está en curso: las nuevas marcas de costo surtirán efecto inmediatamente.

Esta propiedad usa el campo DWORD del BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
Valor: 2
Identificador que se usa para registrar una devolución de llamada COM por CLSID para recibir notificaciones sobre el progreso y la finalización de un trabajo de BITS. El CLSID debe hacer referencia a una clase asociada a un servidor COM fuera de proceso registrado. También se puede establecer en GUID_NULL para borrar un CLSID de notificación establecido previamente.

Esta propiedad usa el campo CLsID de BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
Valor: 3
Identificador para marcar un trabajo de BITS como dispuesto a descargar contenido que no admite los requisitos HTTP normales para descargas de BITS: solicitudes HEAD, el encabezado Content-Length y el encabezado Content-Range. La descarga de este tipo de contenido es opcional, ya que BITS no puede pausar y reanudar las descargas de trabajos sin esa compatibilidad. Si se interrumpe un trabajo con esta propiedad habilitada por cualquier motivo, como una pérdida temporal de conectividad de red o el reinicio del sistema, BITS reiniciará la descarga desde el principio en lugar de reanudar el lugar donde se dejó. BITS tampoco puede limitar el uso del ancho de banda para las descargas dinámicas; BITS no realizará transferencias no limitadas para cualquier trabajo que no tenga asignado BG_JOB_PRIORITY_FOREGROUND , por lo que normalmente debe establecer esa prioridad cada vez que use establecer un trabajo como permitir contenido dinámico.

Esta propiedad usa el campo Enable del BITS_JOB_PROPERTY_VALUE. Esta propiedad solo se admite para trabajos de BG_JOB_TYPE_DOWNLOAD . No se admite para las descargas que usan FILE_RANGES. Esta propiedad solo se puede establecer antes de la primera vez que se llama a Resume en un trabajo.
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
Valor: 4
Identificador para marcar un trabajo de BITS como no requiere garantías de confiabilidad sólidas. La habilitación de esta propiedad hará que BITS evite conservar información sobre el progreso normal del trabajo, que BITS normalmente realiza periódicamente. En caso de un apagado inesperado, como una pérdida de energía, durante una transferencia, esto hará que BITS pierda el progreso.

y reinicie el trabajo desde el principio en lugar de reanudar desde donde se dejó como de costumbre. Sin embargo, también reducirá el número de escrituras de disco que BITS realiza durante la duración de un trabajo, lo que puede mejorar el rendimiento de los trabajos más pequeños.

Esta propiedad también hace que BITS se descargue directamente en el archivo de destino, en lugar de descargarlo en un archivo temporal y mover el archivo temporal al destino final una vez completada la transferencia. Esto significa que BITS no limpiará ningún contenido descargado parcialmente si un trabajo se cancela o encuentra una condición de error grave; el llamador de BITS es responsable de limpiar el archivo de destino, si se crea. Sin embargo, también reducirá ligeramente la sobrecarga del disco.

Esta propiedad solo se recomienda para escenarios que implican un gran número de trabajos pequeños (menos de 1 MB) y que no requieren confiabilidad para la pérdida de energía u otros eventos de apagado inesperados. El ahorro de rendimiento no suele ser significativo para un número reducido de trabajos o para trabajos mayores.

Esta propiedad usa el campo Enable del BITS_JOB_PROPERTY_VALUE. Esta propiedad solo se admite para trabajos de BG_JOB_TYPE_DOWNLOAD . Esta propiedad solo se puede establecer antes de agregar los archivos a un trabajo.
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
Valor: 5
El identificador para marcar el número máximo de bytes que un trabajo de BITS podrá descargar en total. Esta propiedad está pensada para su uso con BITS_JOB_PROPERTY_DYNAMIC_CONTENT, donde es posible que no pueda determinar el tamaño del archivo que se va a descargar con antelación, pero desea limitar el tamaño total de descarga posible.

Esta propiedad usa el campo Enable del BITS_JOB_PROPERTY_VALUE. Esta propiedad solo se admite para trabajos de BG_JOB_TYPE_DOWNLOAD . Esta propiedad solo se puede establecer antes de la primera vez que se llama a Resume en un trabajo.
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
Valor: 7
Identificador para marcar un trabajo de BITS como dispuesto a incluir credenciales predeterminadas en las solicitudes a los servidores proxy. Habilitar esta propiedad equivale a establecer un nivel de seguridad winHTTP de WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM en las solicitudes que BITS realiza en nombre del usuario. El usuario BITS recupera las credenciales almacenadas de es la misma que la que realiza solicitudes de red en nombre de: BITS normalmente usará las credenciales del propietario del trabajo, a menos que haya proporcionado explícitamente un token auxiliar de red, en cuyo caso BITS usará las credenciales del token del asistente de red.

Esta propiedad usa el campo Target del BITS_JOB_PROPERTY_VALUE. Sin embargo, solo se admite el destino de BG_AUTH_TARGET_PROXY .
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
Valor: 9
Identificador que se usa para controlar el tiempo de las notificaciones JobNotification y FileRangesTransferred de BITS. La habilitación de esta propiedad permite a un usuario recibir notificaciones a una velocidad diferente. Esta propiedad puede cambiarse mientras una transferencia está en curso; sin embargo, es posible que la nueva tarifa no se aplique inmediatamente. El valor predeterminado es 500 milisegundos.

Esta propiedad usa el campo DWORD del BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_ON_DEMAND_MODE
Valor: 10
Identificador que se usa para controlar si un trabajo está en modo a petición. Los trabajos a petición permiten que la aplicación solicite intervalos concretos para una descarga de archivos en lugar de descargar desde el principio hasta el final. El valor predeterminado es FALSE; el trabajo no está a petición. Los intervalos se solicitan mediante el método IBackgroundCopyFile6::RequestFileRanges .

Esta propiedad usa el campo Enable del BITS_JOB_PROPERTY_VALUE.

Los requisitos de un trabajo de BITS_JOB_PROPERTY_ON_DEMAND_MODE es que la transferencia debe ser un trabajo de BG_JOB_TYPE_DOWNLOAD . El trabajo no debe ser DINÁMICO y el servidor debe ser un servidor HTTP o HTTPS y se deben cumplir todos los requisitos de servidor para la compatibilidad con intervalos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8
Servidor mínimo compatible Windows Server 2012
Encabezado bits5_0.h

Consulte también