Interfaz 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.
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 .
Miembros
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.
| Método | Descripción |
|---|---|
| Cancelar | Cancela el trabajo y quita los archivos temporales del cliente. |
| Completo | Finaliza el trabajo y guarda los archivos transferidos en el cliente. |
| EnumFiles | Devuelve un puntero de interfaz a un objeto enumerador que se usa para enumerar los archivos del trabajo. |
| GetDisplayName | Recupera el nombre para mostrar que identifica el trabajo. |
| GetError | Recupera un puntero de interfaz al objeto de error después de producirse un error. |
| GetId | Recupera el identificador del trabajo en la cola. |
| GetNoProgressTimeout | Recupera el período de tiempo que la Optimización de distribución sigue intentando transferir el archivo después de encontrar una condición de error transitoria. |
| GetNotifyFlags | Recupera las marcas de notificación de eventos (devolución de llamada) que ha establecido para la aplicación. |
| GetNotifyInterface | Recupera un puntero a la implementación de la interfaz IBackgroundCopyCallback (devoluciones de llamada). |
| GetPriority | Recupera el nivel de prioridad que ha establecido para el trabajo. |
| GetProgress | Recupera información de progreso relacionada con el trabajo, como el número de bytes y archivos transferidos al cliente. |
| GetState | Recupera el estado del trabajo. |
| GetTimes | Recupera marcas de tiempo para las actividades relacionadas con el trabajo, como la hora en que se creó el trabajo. |
| Gettype | Recupera el tipo de transferencia que se realiza, como una descarga de archivos. |
| Reanudar | Inicia un nuevo trabajo o reinicia un trabajo suspendido. |
| SetNoProgressTimeout | Especifica el período de tiempo durante el que optimización de distribución continúa intentando transferir el archivo después de encontrar una condición de error transitoria. |
| SetNotifyFlags | Especifica el tipo de notificación de eventos que se va a recibir. |
| SetNotifyInterface | Especifica un puntero a la implementación de la interfaz IBackgroundCopyCallback (devoluciones de llamada). La interfaz recibe una notificación basada en las marcas de notificación de eventos que establezca. |
| SetPriority | Especifica la prioridad del trabajo en relación con otros trabajos de la cola de transferencia. |
| Suspender | Pausa el trabajo. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 10, versión 1709 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server, versión 1709 [solo aplicaciones de escritorio] |
| Encabezado |
|
| IDL |
|
| Biblioteca |
|
| Archivo DLL |
|
| IID |
IID_IBackgroundCopyJob se define como 37668D37-507E-4160-9316-26306D150B12 |