Servicio de transferencia inteligente en segundo plano

Artículo
03/16/2023

Información general sobre la tecnología del servicio de transferencia inteligente en segundo plano.

Para desarrollar el servicio de transferencia inteligente en segundo plano, necesita estos encabezados:

Para obtener instrucciones de programación para esta tecnología, consulte:

Servicio de transferencia inteligente en segundo plano

Enumeraciones


BG_AUTH_SCHEME Define constantes que especifican el esquema de autenticación que se usará cuando un servidor proxy o servidor solicita autenticación de usuario.
BG_AUTH_TARGET Define constantes que especifican si las credenciales se usan para las solicitudes de autenticación de usuario de servidor o proxy.
BG_CERT_STORE_LOCATION Define constantes que especifican la ubicación del almacén de certificados.
BG_ERROR_CONTEXT Define constantes que especifican el contexto en el que se produjo el error.
BG_JOB_PRIORITY Define constantes que especifican el nivel de prioridad de un trabajo.
BG_JOB_PROXY_USAGE Define constantes que especifican qué proxy se va a usar para las transferencias de archivos. Puede definir una configuración de proxy diferente para cada trabajo.
BG_JOB_STATE Define constantes que especifican los distintos estados de un trabajo.
BG_JOB_TYPE Define constantes que especifican el tipo de trabajo de transferencia, como la descarga.
BITS_FILE_PROPERTY_ID Define constantes que especifican valores de identificador correspondientes a las propiedades del archivo de copia en segundo plano.
BITS_JOB_PROPERTY_ID Define constantes que especifican el identificador de la propiedad para el trabajo de BITS.
BITS_JOB_TRANSFER_POLICY Define constantes que especifican valores de identificador correspondientes a las propiedades de BITS.
GROUPPROP La enumeración GROUPPROP define los valores constantes para recuperar y establecer valores de propiedad de grupo.

Functions


AddFile Agrega un único archivo al trabajo.
AddFiles Use el método AddFiles para agregar uno o varios archivos para descargar en el trabajo.
AddFileSet Agrega varios archivos a un trabajo.
AddFileWithRanges Agrega un archivo a un trabajo de descarga y especifica los intervalos del archivo que desea descargar.
Cancelar Elimina el trabajo de la cola de transferencia y quita los archivos temporales relacionados del cliente (descargas) y el servidor (cargas).
CancelGroup Use el método CancelGroup para quitar el grupo de la cola. Los archivos completamente descargados antes de llamar a este método están disponibles para el cliente. Puede cancelar un grupo en cualquier momento; sin embargo, el grupo no se puede recuperar una vez cancelado.
ClearHelperToken Descarta el token del asistente y no cambia las marcas de uso.
ClearPeers Quita todos los elementos del mismo nivel de la lista de elementos del mismo nivel que pueden servir contenido.
ClearRecords Quita todos los registros y archivos de la memoria caché.
Clonar Crea otro enumerador IEnumBackgroundCopyFiles que contiene el mismo estado de enumeración que el actual.
Clonar Crea otro enumerador IEnumBackgroundCopyJobs que contiene el mismo estado de enumeración que el actual.
Clonar Crea otro enumerador IEnumBitsPeerCacheRecords que contiene el mismo estado de enumeración que el actual.
Clonar Crea otro enumerador IEnumBitsPeers que contiene el mismo estado de enumeración que el actual.
Clonar Use el método Clone para crear otro enumerador IEnumBackgroundCopyGroups que contenga el mismo estado de enumeración que el actual.
Clonar Use el método Clone para crear otro enumerador IEnumBackgroundCopyJobs1 que contenga el mismo estado de enumeración que el actual.
Completo Finaliza el trabajo y guarda los archivos transferidos en el cliente.
CreateGroup Use el método CreateGroup para crear un grupo y agregarlo a la cola de descarga.
CreateJob Crea un trabajo.
CreateJob Use el método CreateJob para agregar un nuevo trabajo al grupo. Un grupo solo puede contener un trabajo.
DeleteRecord Elimina un registro y un archivo de la memoria caché. Este método usa el identificador del registro para identificar el registro que se va a eliminar.
DeleteUrl Elimina todos los registros de caché y el archivo de la memoria caché de la dirección URL especificada.
DisableBITSUploads Use el método DisableBITSUploads para deshabilitar la carga de BITS en el directorio virtual al que apunta el objeto ADSI. Este método establece la propiedad de extensión DE IIS BITSUploadEnabled.
DiscoverPeers Genera una lista de elementos del mismo nivel que pueden servir contenido.
EnableBITSUploads Use el método EnableBITSUploads para habilitar la carga de BITS en el directorio virtual al que apunta el objeto ADSI. Este método establece la propiedad de extensión DE IIS BITSUploadEnabled.
EnumFiles Recupera un puntero de interfaz IEnumBackgroundCopyFiles que se usa para enumerar los archivos de un trabajo.
EnumGroups Use el método EnumGroups para recuperar una lista de grupos que posee el usuario actual. Si el usuario actual tiene privilegios de administrador, el método devuelve todos los grupos de la cola.
EnumJobs Recupera un puntero de interfaz a un objeto enumerador que se usa para enumerar los trabajos de la cola de transferencia. El orden de los trabajos del enumerador es arbitrario.
EnumJobs Use el método EnumJobs para recuperar una lista de trabajos del grupo. La lista contiene solo un trabajo.
EnumPeers Obtiene un puntero de interfaz IEnumBitsPeers que se usa para enumerar los elementos del mismo nivel que pueden servir contenido. La enumeración es una instantánea de los registros de la memoria caché.
EnumRecords Obtiene un puntero de interfaz IEnumBitsPeerCacheRecords que se usa para enumerar los registros de la memoria caché. La enumeración es una instantánea de los registros de la memoria caché.
FileRangesTransferred BITS llama a la implementación del método FileRangesTransferred cuando se han descargado uno o varios intervalos de archivos. Los intervalos de archivos se agregan al trabajo mediante el método IBackgroundCopyFile6::RequestFileRanges.
FileTransferred BITS llama a la implementación del método FileTransferred cuando BITS finaliza correctamente la transferencia de un archivo.
get_GroupID Use el método get_GroupID para recuperar el identificador del grupo.
get_JobID Use el método get_JobID para recuperar el identificador del trabajo.
get_Size Use el método get_Size para recuperar el tamaño de todos los archivos del grupo que se van a descargar.
GetCleanupTask Use el método GetCleanupTask para recuperar un puntero de interfaz a la tarea de limpieza asociada al directorio virtual.
GetCleanupTaskName Use el método GetCleanupTaskName para recuperar el nombre de la tarea de limpieza asociada al directorio virtual.
GetClientCertificate Recupera el certificado de cliente del trabajo.
GetConfigurationFlags Obtiene las marcas de configuración que determinan si el equipo sirve contenido a elementos del mismo nivel y puede descargar contenido de elementos del mismo nivel.
GetCount Recupera un recuento del número de archivos de la enumeración.
GetCount Recupera un recuento del número de trabajos de la enumeración.
GetCount Recupera un recuento del número de registros de caché en la enumeración.
GetCount Recupera un recuento del número de elementos del mismo nivel de la enumeración.
GetCount Use el método GetCount para recuperar un recuento del número de grupos de la enumeración.
GetCount Use el método GetCount para recuperar un recuento del número de trabajos de la enumeración.
GetCustomHeaders Recupera los encabezados personalizados establecidos por una llamada anterior a IBackgroundCopyJobHttpOptions::SetCustomHeaders (es decir, los encabezados que BITS enviarán al remoto, no los encabezados que BITS recibe del remoto).
GetDescription Recupera la descripción del trabajo.
GetDisplayName Recupera el nombre para mostrar del trabajo. Normalmente, se usa el nombre para mostrar para identificar el trabajo en una interfaz de usuario.
GetError Recupera el código de error e identifica el contexto en el que se produjo el error.
GetError Recupera la interfaz de error después de producirse un error.
GetErrorContextDescription Recupera la descripción del contexto en el que se produjo el error.
GetErrorCount Recupera el número de veces que BITS intentó transferir el trabajo y se produjo un error.
GetErrorDescription Recupera el texto de error asociado al error.
GetErrorDescription Recupera una descripción para el código de error especificado.
GetFile Recupera un puntero de interfaz al objeto de archivo asociado al error.
GetFile Use el método GetFile para recuperar los nombres de archivo remoto y local del archivo especificado en el trabajo.
GetFileACLFlags Recupera las marcas que identifican la información del propietario y la ACL que se deben mantener al transferir un archivo mediante SMB.
GetFileCount Use el método GetFileCount para recuperar el número de archivos del trabajo.
GetFileModificationTime Obtiene la fecha y hora en que el archivo se modificó por última vez en el servidor.
GetFileRanges Obtiene los intervalos del archivo que se encuentran en la memoria caché.
GetFileRanges Recupera los intervalos que desea descargar desde el archivo remoto.
GetFileSize Obtiene el tamaño del archivo.
GetFilledFileRanges Devuelve el conjunto de intervalos de archivos que se han descargado.
GetGroup Use el método GetGroup para recuperar un grupo de la cola de descarga.
GetHelperTokenFlags Devuelve las marcas de uso de un token asociado a un trabajo de transferencia de BITS.
GetHelperTokenSid Devuelve el SID del token auxiliar si se establece uno.
GetHttpMethod Recupera una cadena ancha que contiene el nombre del método HTTP para la transferencia de BITS. De forma predeterminada, los trabajos de descarga serán "GET" y los trabajos de carga y respuesta serán "BITS_POST".
GetId Recupera el identificador usado para identificar el trabajo en la cola.
GetId Obtiene el identificador que identifica de forma única el registro en la memoria caché.
GetJob Recupera un trabajo especificado de la cola de transferencia. Normalmente, la aplicación conserva el identificador de trabajo, por lo que más adelante puede recuperar el trabajo de la cola.
GetJob Use el método GetJob para recuperar un trabajo del grupo.
GetLastAccessTime Obtiene la fecha y hora en que se ha accedido por última vez al archivo.
GetLocalName Recupera el nombre local del archivo.
GetMaximumCacheSize Obtiene el tamaño máximo de la memoria caché.
GetMaximumContentAge Obtiene la antigüedad cuando se quitan los archivos de la memoria caché.
GetMaximumDownloadTime Recupera el tiempo máximo que BITS dedicará a transferir los archivos en el trabajo.
GetMinimumRetryDelay Recupera el período mínimo de tiempo que el servicio espera después de encontrar una condición de error transitoria antes de intentar transferir el archivo.
GetNoProgressTimeout Recupera el período de tiempo que el servicio intenta transferir el archivo después de que se produzca una condición de error transitoria. Si hay progreso, se restablece el temporizador.
GetNotifyCmdLine Recupera el programa que se va a ejecutar cuando el trabajo entra en el estado de error o transferido.
GetNotifyFlags Recupera las marcas de notificación de eventos para el trabajo.
GetNotifyInterface Recupera el puntero de interfaz a la implementación de la interfaz IBackgroundCopyCallback.
GetObject Use el método GetObject para recuperar un puntero a la interfaz IBITSExtensionSetup. Este método realiza el mismo enlace que realiza la función ADSI ADsGetObject.
GetOriginUrl Obtiene la dirección URL de origen del archivo almacenado en caché.
GetOwner Recupera la identidad del propietario del trabajo.
GetOwnerElevationState Obtiene un valor que determina si el token del propietario se ha elevado en el momento en que creó o tomó posesión del trabajo.
GetOwnerIntegrityLevel Obtiene el nivel de integridad del token del propietario que creó o tomó posesión del trabajo.
GetPeerCachingFlags Recupera marcas que determinan si los archivos del trabajo se pueden almacenar en caché y servir a elementos del mismo nivel y si BITS puede descargar contenido para el trabajo de elementos del mismo nivel.
GetPeerDownloadStats Especifica estadísticas sobre la cantidad de datos descargados de servidores del mismo nivel y de origen.
GetPeerName Obtiene el nombre principal del servidor que identifica de forma única el elemento del mismo nivel.
GetPriority Recupera el nivel de prioridad del trabajo. El nivel de prioridad determina cuándo se procesa el trabajo en relación con otros trabajos de la cola de transferencia.
GetProgress Recupera información sobre el progreso de la transferencia de archivos.
GetProgress Recupera información de progreso relacionada con el trabajo, como el número de bytes y archivos transferidos.
GetProgress Use el método GetProgress para recuperar el progreso de la descarga.
GetProgress Use el método GetProgress para recuperar el progreso del trabajo.
GetProp Use el método GetProp para recuperar un valor de propiedad del grupo.
GetProperty Obtiene una propiedad genérica de una transferencia de archivos BITS.
GetProperty Método genérico para obtener propiedades de trabajo de BITS.
GetProtocol Recupera el protocolo usado para transferir el archivo. El nombre de archivo remoto identifica el protocolo que se va a usar para transferir el archivo.
GetProxySettings Recupera la información de proxy que usa el trabajo para transferir los archivos.
GetRecord Obtiene un registro de la memoria caché.
GetRemoteName Recupera el nombre remoto del archivo.
GetReplyData Recupera una copia en memoria de los datos de respuesta de la aplicación de servidor. Llame a este método solo si el tipo del trabajo es BG_JOB_TYPE_UPLOAD_REPLY y su estado es BG_JOB_STATE_TRANSFERRED.
GetReplyFileName Recupera el nombre del archivo que contiene los datos de respuesta de la aplicación de servidor. Llame a este método solo si el tipo de trabajo es BG_JOB_TYPE_UPLOAD_REPLY.
GetReplyProgress Recupera información de progreso relacionada con la transferencia de los datos de respuesta de un trabajo de carga-respuesta.
GetSecurityFlags Recupera las marcas de HTTP que determinan si se comprueba la lista de revocación de certificados y se omiten determinados errores de certificado y la directiva que se va a usar cuando un servidor redirige la solicitud HTTP.
GetState Recupera el estado del trabajo.
GetStatus Use el método GetStatus para recuperar el estado del grupo.
GetStatus Use el método GetStatus para recuperar el estado del trabajo.
GetTemporaryName Obtiene la ruta de acceso completa del archivo temporal que contiene el contenido de la descarga.
GetTimes Recupera marcas de tiempo relacionadas con el trabajo, como la hora en que se creó o modificó por última vez el trabajo.
GetType Recupera el tipo de transferencia que se realiza, como una descarga o carga de archivos.
GetValidationState Obtiene el estado de validación actual de este archivo.
IsAuthenticated Determina si el elemento del mismo nivel está autenticado.
IsAvailable Determina si el elemento del mismo nivel está disponible (en línea) para proporcionar contenido.
IsDownloadedFromPeer Obtiene un valor que determina si alguna parte del archivo se descargó de un elemento del mismo nivel.
IsFileValidated Determina si el archivo se ha validado.
JobError BITS llama a la implementación del método JobError cuando el estado del trabajo cambia a BG_JOB_STATE_ERROR.
JobModification BITS llama a la implementación del método JobModification cuando se ha modificado el trabajo.
JobTransferred BITS llama a la implementación del método JobTransferred cuando todos los archivos del trabajo se han transferido correctamente.
MakeCustomHeadersWriteOnly Establece los encabezados personalizados HTTP para que este trabajo sea de solo escritura.
Siguiente Recupera un número especificado de elementos en la secuencia de enumeración. Si hay menos del número solicitado de elementos que quedan en la secuencia, recupera los elementos restantes. (IEnumBackgroundCopyFiles.Next)
Siguiente Recupera un número especificado de elementos en la secuencia de enumeración. Si hay menos del número solicitado de elementos que quedan en la secuencia, recupera los elementos restantes. (IEnumBackgroundCopyJobs.Next)
Siguiente Recupera un número especificado de elementos en la secuencia de enumeración. Si hay menos del número solicitado de elementos que quedan en la secuencia, recupera los elementos restantes. (IEnumBitsPeerCacheRecords.Next)
Siguiente Recupera un número especificado de elementos en la secuencia de enumeración. Si hay menos del número solicitado de elementos que quedan en la secuencia, recupera los elementos restantes. (IEnumBitsPeers.Next)
Siguiente Use el método Next para recuperar el número especificado de elementos de la secuencia de enumeración. Si hay menos del número solicitado de elementos que quedan en la secuencia, recupera los elementos restantes. (IEnumBackgroundCopyGroups.Next)
Siguiente Use el método Next para recuperar el número especificado de elementos de la secuencia de enumeración. Si hay menos del número solicitado de elementos que quedan en la secuencia, recupera los elementos restantes. (IEnumBackgroundCopyJobs1.Next)
OnStatus Implemente el método OnStatus para recibir una notificación cuando se complete el grupo o se produzca un error.
RemoveClientCertificate Quita el certificado de cliente del trabajo.
RemoveCredentials Quita las credenciales de uso. Las credenciales deben coincidir con un par de destinos y esquemas existente que especificó mediante el método IBackgroundCopyJob2::SetCredentials. No hay ningún método para recuperar las credenciales que ha establecido.
ReplaceRemotePrefix Reemplaza el texto inicial de todos los nombres remotos del trabajo de descarga por la cadena especificada.
RequestFileRanges Agrega un nuevo conjunto de intervalos de archivos que se van a priorizar para su descarga.
Reset Restablece la secuencia de enumeración al principio. (IEnumBackgroundCopyFiles.Reset)
Reset Restablece la secuencia de enumeración al principio. (IEnumBackgroundCopyJobs.Reset)
Reset Restablece la secuencia de enumeración al principio. (IEnumBitsPeerCacheRecords.Reset)
Reset Restablece la secuencia de enumeración al principio. (IEnumBitsPeers.Reset)
Reset Use el método Reset para restablecer la secuencia de enumeración al principio. (IEnumBackgroundCopyGroups.Reset)
Reset Use el método Reset para restablecer la secuencia de enumeración al principio. (IEnumBackgroundCopyJobs1.Reset)
Reanudar Activa un nuevo trabajo o reinicia un trabajo que se ha suspendido.
ResumeGroup Use el método ResumeGroup para iniciar un grupo suspendido en la cola de descarga.
SetClientCertificateByID Especifica el identificador del certificado de cliente que se va a usar para la autenticación de cliente en una solicitud HTTPS (SSL).
SetClientCertificateByName Especifica el nombre del firmante del certificado de cliente que se va a usar para la autenticación de cliente en una solicitud HTTPS (SSL).
SetConfigurationFlags Establece las marcas de configuración que determinan si el equipo puede servir contenido a elementos del mismo nivel y puede descargar contenido de elementos del mismo nivel.
SetCredentials Especifica las credenciales que se usarán para una solicitud de autenticación de usuario de servidor remoto o proxy.
SetCustomHeaders Especifica uno o varios encabezados HTTP personalizados que se van a incluir en las solicitudes HTTP.
SetDescription Proporciona una descripción del trabajo.
SetDisplayName Especifica un nombre para mostrar para el trabajo. Normalmente, se usa el nombre para mostrar para identificar el trabajo en una interfaz de usuario.
SetFileACLFlags Especifica la información del propietario y la ACL que se deben mantener al usar SMB para descargar o cargar un archivo.
SetHelperToken Establece el token auxiliar para suplantar el token del cliente COM.
SetHelperTokenFlags Establece las marcas de uso de un token asociado a un trabajo de transferencia de BITS.
SetHttpMethod Invalida el método HTTP predeterminado usado para una transferencia de BITS.
SetMaximumCacheSize Especifica el tamaño máximo de la memoria caché.
SetMaximumContentAge Especifica cuándo se quitan los archivos de la memoria caché en función de la antigüedad.
SetMaximumDownloadTime Establece el tiempo máximo que BITS dedicará a transferir los archivos en el trabajo.
SetMinimumRetryDelay Establece el período mínimo de tiempo que BITS espera después de encontrar una condición de error transitorio antes de intentar transferir el archivo.
SetNoProgressTimeout Establece el período de tiempo que BITS intenta transferir el archivo después de que se produzca una condición de error transitoria. Si hay progreso, se restablece el temporizador.
SetNotifyCmdLine Especifica un programa que se va a ejecutar si el trabajo entra en el estado BG_JOB_STATE_ERROR o BG_JOB_STATE_TRANSFERRED. BITS ejecuta el programa en el contexto del usuario que llamó a este método.
SetNotifyFlags Especifica el tipo de notificación de eventos que desea recibir, como eventos transferidos de trabajo.
SetNotifyInterface Identifica la implementación de la interfaz IBackgroundCopyCallback en BITS. Use la interfaz IBackgroundCopyCallback para recibir notificaciones de eventos relacionados con el trabajo.
SetPeerCachingFlags Establece marcas que determinan si los archivos del trabajo se pueden almacenar en caché y servir a elementos del mismo nivel y si el trabajo puede descargar contenido de elementos del mismo nivel.
SetPriority Especifica el nivel de prioridad del trabajo. El nivel de prioridad determina cuándo se procesa el trabajo en relación con otros trabajos de la cola de transferencia.
SetProp Utilice el método SetProp para establecer el valor de propiedad de una propiedad de grupo.
SetProperty Establece una propiedad genérica de una transferencia de archivos BITS.
SetProperty Método genérico para establecer propiedades de trabajo de BITS.
SetProxySettings Especifica el proxy que se va a usar para transferir archivos.
SetRemoteName Cambia el nombre remoto a una nueva dirección URL en un trabajo de descarga.
SetReplyFileName Especifica el nombre del archivo que va a contener los datos de respuesta de la aplicación de servidor. Llame a este método solo si el tipo del trabajo es BG_JOB_TYPE_UPLOAD_REPLY.
SetSecurityFlags Establece marcas para HTTP que determinan si se comprueba la lista de revocación de certificados y se omiten determinados errores de certificado y la directiva que se va a usar cuando un servidor redirige la solicitud HTTP.
SetServerCertificateValidationInterface Los certificados de servidor se envían cuando se abre una conexión HTTPS. Use este método para establecer una devolución de llamada que se llamará para validar esos certificados de servidor.
SetValidationState Establece el estado de validación de este archivo.
Skip Omite el siguiente número especificado de elementos de la secuencia de enumeración. Si quedan menos elementos en la secuencia que el número solicitado de elementos que se van a omitir, omite el último elemento de la secuencia. (IEnumBackgroundCopyFiles.Skip)
Skip Omite el siguiente número especificado de elementos de la secuencia de enumeración. Si quedan menos elementos en la secuencia que el número solicitado de elementos que se van a omitir, omite el último elemento de la secuencia. (IEnumBackgroundCopyJobs.Skip)
Skip Omite el siguiente número especificado de elementos de la secuencia de enumeración. Si quedan menos elementos en la secuencia que el número solicitado de elementos que se van a omitir, omite el último elemento de la secuencia. (IEnumBitsPeerCacheRecords.Skip)
Skip Omite el siguiente número especificado de elementos de la secuencia de enumeración. Si quedan menos elementos en la secuencia que el número solicitado de elementos que se van a omitir, omite el último elemento de la secuencia. (IEnumBitsPeers.Skip)
Skip Use el método Skip para omitir el siguiente número especificado de elementos de la secuencia de enumeración. Si quedan menos elementos en la secuencia que el número solicitado de elementos que se van a omitir, omite el último elemento de la secuencia. (IEnumBackgroundCopyGroups.Skip)
Skip Use el método Skip para omitir el siguiente número especificado de elementos de la secuencia de enumeración. Si quedan menos elementos en la secuencia que el número solicitado de elementos que se van a omitir, omite el último elemento de la secuencia. (IEnumBackgroundCopyJobs1.Skip)
Suspender Suspende un trabajo. Los nuevos trabajos, los trabajos que están en error y los trabajos que han terminado de transferir archivos se suspenden automáticamente.
SuspendGroup Use el método SuspendGroup para pausar un grupo en la cola de descarga. Los nuevos grupos, grupos que están en error o grupos que han terminado de descargarse se suspenden automáticamente.
SwitchToForeground Use el método SwitchToForeground para descargar el grupo en primer plano en lugar del fondo.
TakeOwnership Cambia la propiedad del trabajo al usuario actual.
UpdateDownloadPosition Especifica una posición para priorizar la descarga de datos que faltan.
ValidateServerCertificate Método de devolución de llamada que se implementará para que pueda validar los certificados de servidor enviados cuando se abra una conexión HTTPS.

Interfaces


IBackgroundCopyCallback Implemente la interfaz IBackgroundCopyCallback para recibir una notificación de que se ha completado un trabajo, se ha modificado o está en error. Los clientes usan esta interfaz en lugar de sondear el estado del trabajo.
IBackgroundCopyCallback1 Implemente la interfaz IBackgroundCopyCallback1 para recibir notificaciones cuando se produzcan eventos.
IBackgroundCopyCallback2 Implemente esta interfaz para recibir una notificación de que un archivo ha completado la descarga.
IBackgroundCopyCallback3 Los clientes implementan la interfaz IBackgroundCopyCallback3 para recibir notificaciones de que los intervalos de un archivo han completado la descarga.
IBackgroundCopyError Use la interfaz IBackgroundCopyError para determinar la causa de un error y si el proceso de transferencia puede continuar.
IBackgroundCopyFile IBackgroundCopyFile contiene información sobre un archivo que forma parte de un trabajo. Por ejemplo, puede usar métodos IBackgroundCopyFile para recuperar los nombres locales y remotos del archivo y transferir información de progreso.
IBackgroundCopyFile2 Use la interfaz IBackgroundCopyFile2 para especificar un nuevo nombre remoto para el archivo y recuperar la lista de intervalos que se van a descargar.
IBackgroundCopyFile3 Use esta interfaz para recuperar el nombre del archivo temporal que contiene el contenido descargado y validar el archivo para que los elementos del mismo nivel puedan solicitar su contenido.
IBackgroundCopyFile4 Use esta interfaz para recuperar estadísticas de descarga de servidores del mismo nivel y de origen.
IBackgroundCopyFile5 Use esta interfaz para obtener o establecer propiedades genéricas de transferencias de archivos BITS.
IBackgroundCopyFile6 Use esta interfaz para solicitar intervalos de archivos para trabajos de descarga a petición.
IBackgroundCopyGroup Use la interfaz IBackgroundCopyGroup para administrar un grupo. Un grupo contiene trabajos de descarga. Por ejemplo, agregue un trabajo al grupo, establezca las propiedades del grupo e inicie y detenga el grupo en la cola de descarga.
IBackgroundCopyJob Use la interfaz IBackgroundCopyJob para agregar archivos al trabajo, establecer el nivel de prioridad del trabajo, determinar el estado del trabajo y iniciar y detener el trabajo.
IBackgroundCopyJob1 Use la interfaz IBackgroundCopyJob1 para agregar archivos al trabajo y recuperar el estado del trabajo.
IBackgroundCopyJob2 Recupere los datos de respuesta de un trabajo de carga-respuesta, determine el progreso de la transferencia de datos de respuesta al cliente, solicite la ejecución de la línea de comandos y proporcione credenciales para las solicitudes de autenticación de servidor proxy y remoto.
IBackgroundCopyJob3 Use la interfaz IBackgroundCopyJob3 para descargar intervalos de un archivo y cambiar el prefijo de un nombre de archivo remoto.
IBackgroundCopyJob4 Use esta interfaz para habilitar el almacenamiento en caché del mismo nivel, restringir el tiempo de descarga e inspeccionar las características del token de usuario.
IBackgroundCopyJob5 Use esta interfaz para consultar o establecer varios comportamientos opcionales de un trabajo.
IBackgroundCopyJobHttpOptions Use esta interfaz para especificar certificados de cliente para la autenticación de cliente basada en certificados y encabezados personalizados para las solicitudes HTTP.
IBackgroundCopyJobHttpOptions2 Use esta interfaz para recuperar o invalidar el método HTTP usado para una transferencia de BITS.
IBackgroundCopyJobHttpOptions3 Use esta interfaz para establecer encabezados de cliente HTTP en solo escritura o para establecer un método de devolución de llamada de validación de certificados de servidor que haya implementado.
IBackgroundCopyManager Crea trabajos de transferencia, recupera un objeto de enumerador que contiene los trabajos de la cola y recupera trabajos individuales de la cola.
IBackgroundCopyQMgr Use la interfaz IBackgroundCopyQMgr para crear un nuevo grupo, recuperar un grupo existente o enumerar todos los grupos de la cola. Un grupo contiene un trabajo de descarga.
IBackgroundCopyServerCertificateValidationCallback Los certificados de servidor se envían cuando se abre una conexión HTTPS. Use este método para implementar una devolución de llamada a la que se llamará para validar esos certificados de servidor.
IBITSExtensionSetup Use la interfaz IBITSExtensionSetup para habilitar o deshabilitar las cargas de BITS en un directorio virtual.
IBITSExtensionSetupFactory Use la interfaz IBITSExtensionSetupFactory para obtener un puntero a la interfaz IBITSExtensionSetup.
IBitsPeer Usa IBitsPeer para obtener información sobre un par en el vecindario.
IBitsPeerCacheAdministration Use IBitsPeerCacheAdministration para administrar el grupo de elementos del mismo nivel desde el que puede descargar contenido.
IBitsPeerCacheRecord Use IBitsPeerCacheRecord para obtener información sobre un archivo en la memoria caché.
IBitsTokenOptions Use IBitsTokenOptions para asociar y administrar un par de tokens de seguridad para un trabajo de transferencia de Servicio de transferencia inteligente en segundo plano (BITS).
IEnumBackgroundCopyFiles Use la interfaz IEnumBackgroundCopyFiles para enumerar los archivos que contiene un trabajo. Para obtener un puntero de interfaz IEnumBackgroundCopyFiles, llame al método IBackgroundCopyJob::EnumFiles.
IEnumBackgroundCopyGroups Use la interfaz IEnumBackgroundCopyGroups para enumerar la lista de grupos de la cola de descarga. Para obtener un puntero de interfaz IEnumBackgroundCopyGroups, llame al método IBackgroundCopyQMgr::EnumGroups.
IEnumBackgroundCopyJobs Use la interfaz IEnumBackgroundCopyJobs para enumerar la lista de trabajos de la cola de transferencia. Para obtener un puntero de interfaz IEnumBackgroundCopyJobs, llame al método IBackgroundCopyManager::EnumJobs.
IEnumBackgroundCopyJobs1 Use la interfaz IEnumBackgroundCopyJobs1 para enumerar la lista de trabajos de un grupo. Para obtener un puntero de interfaz IEnumBackgroundCopyJobs1, llame al método IBackgroundCopyGroup::EnumJobs.
IEnumBitsPeerCacheRecords Use IEnumBitsPeerCacheRecords para enumerar los registros de la memoria caché.
IEnumBitsPeers Use IEnumBitsPeers para enumerar la lista de elementos del mismo nivel que BITS ha detectado.

Estructuras


BG_AUTH_CREDENTIALS Identifica el destino (proxy o servidor), el esquema de autenticación y las credenciales del usuario que se van a usar para las solicitudes de autenticación de usuario. La estructura se pasa al método IBackgroundCopyJob2::SetCredentials.
BG_AUTH_CREDENTIALS_UNION Identifica las credenciales que se van a usar para el esquema de autenticación especificado en la estructura de BG_AUTH_CREDENTIALS.
BG_BASIC_CREDENTIALS La estructura BG_BASIC_CREDENTIALS identifica el nombre de usuario y la contraseña que se van a autenticar.
BG_FILE_INFO Proporciona los nombres locales y remotos del archivo que se van a transferir.
BG_FILE_PROGRESS Proporciona información de progreso relacionada con archivos, como el número de bytes transferidos.
BG_FILE_RANGE Identifica un intervalo de bytes para descargar desde un archivo.
BG_JOB_PROGRESS Proporciona información de progreso relacionada con el trabajo, como el número de bytes y archivos transferidos.
BG_JOB_REPLY_PROGRESS Proporciona información de progreso relacionada con la parte de respuesta de un trabajo de carga-respuesta.
BG_JOB_TIMES Proporciona marcas de tiempo relacionadas con el trabajo.
BITS_FILE_PROPERTY_VALUE Proporciona el valor de propiedad de un archivo BITS.
BITS_JOB_PROPERTY_VALUE Proporciona el valor de propiedad del trabajo de BITS en función del valor de la enumeración BITS_JOB_PROPERTY_ID.
FILESETINFO La estructura FILESETINFO identifica los nombres remotos y locales del archivo que se van a descargar.