Interfaz IBackgroundCopyJob (bits.h)
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.
Para crear un trabajo, llame al método IBackgroundCopyManager::CreateJob . Para obtener un puntero de interfaz IBackgroundCopyJob a un trabajo existente, llame al método IBackgroundCopyManager::GetJob .
Herencia
La interfaz IBackgroundCopyJob hereda de la interfaz IUnknown . IBackgroundCopyJob también tiene estos tipos de miembros:
Métodos
La interfaz IBackgroundCopyJob tiene estos métodos.
| IBackgroundCopyJob::AddFile Agrega un único archivo al trabajo. |
| IBackgroundCopyJob::AddFileSet Agrega varios archivos a un trabajo. |
| IBackgroundCopyJob::Cancel Elimina el trabajo de la cola de transferencia y quita los archivos temporales relacionados del cliente (descargas) y el servidor (cargas). |
| IBackgroundCopyJob::Complete Finaliza el trabajo y guarda los archivos transferidos en el cliente. |
| IBackgroundCopyJob::EnumFiles Recupera un puntero de interfaz IEnumBackgroundCopyFiles que se usa para enumerar los archivos de un trabajo. |
| IBackgroundCopyJob::GetDescription Recupera la descripción del trabajo. |
| IBackgroundCopyJob::GetDisplayName Recupera el nombre para mostrar del trabajo. Normalmente, se usa el nombre para mostrar para identificar el trabajo en una interfaz de usuario. |
| IBackgroundCopyJob::GetError Recupera la interfaz de error después de producirse un error. |
| IBackgroundCopyJob::GetErrorCount Recupera el número de veces que BITS intentó transferir el trabajo y se produjo un error. |
| IBackgroundCopyJob::GetId Recupera el identificador usado para identificar el trabajo en la cola. |
| IBackgroundCopyJob::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. |
| IBackgroundCopyJob::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. |
| IBackgroundCopyJob::GetNotifyFlags Recupera las marcas de notificación de eventos para el trabajo. |
| IBackgroundCopyJob::GetNotifyInterface Recupera el puntero de interfaz a la implementación de la interfaz IBackgroundCopyCallback. |
| IBackgroundCopyJob::GetOwner Recupera la identidad del propietario del trabajo. |
| IBackgroundCopyJob::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. |
| IBackgroundCopyJob::GetProgress Recupera información de progreso relacionada con el trabajo, como el número de bytes y archivos transferidos. |
| IBackgroundCopyJob::GetProxySettings Recupera la información de proxy que usa el trabajo para transferir los archivos. |
| IBackgroundCopyJob::GetState Recupera el estado del trabajo. |
| IBackgroundCopyJob::GetTimes Recupera marcas de tiempo relacionadas con el trabajo, como la hora en que se creó o modificó por última vez el trabajo. |
| IBackgroundCopyJob::GetType Recupera el tipo de transferencia que se realiza, como una descarga o carga de archivos. |
| IBackgroundCopyJob::Resume Activa un nuevo trabajo o reinicia un trabajo que se ha suspendido. |
| IBackgroundCopyJob::SetDescription Proporciona una descripción del trabajo. |
| IBackgroundCopyJob::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. |
| IBackgroundCopyJob::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. |
| IBackgroundCopyJob::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. |
| IBackgroundCopyJob::SetNotifyFlags Especifica el tipo de notificación de eventos que desea recibir, como eventos transferidos de trabajo. |
| IBackgroundCopyJob::SetNotifyInterface Identifica la implementación de la interfaz IBackgroundCopyCallback en BITS. Use la interfaz IBackgroundCopyCallback para recibir notificaciones de eventos relacionados con el trabajo. |
| IBackgroundCopyJob::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. |
| IBackgroundCopyJob::SetProxySettings Especifica el proxy que se va a usar para transferir archivos. |
| IBackgroundCopyJob::Suspend 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. |
| IBackgroundCopyJob::TakeOwnership Cambia la propiedad del trabajo al usuario actual. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP |
| Servidor mínimo compatible | Windows Server 2003 |
| Plataforma de destino | Windows |
| Encabezado | bits.h |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de