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

IBackgroundCopyFile

IBackgroundCopyJob2

IBackgroundCopyJob3

IBackgroundCopyManager

IEnumBackgroundCopyJobs