IBackgroundCopyJob::Complete (Método)

Finaliza el trabajo y guarda los archivos transferidos en el cliente.

Sintaxis

HRESULT Complete();

Parámetros

Este método no tiene parámetros.

Valor devuelto

Este método devuelve los siguientes valores HRESULT. El método también puede devolver errores relacionados con el cambio de nombre de las copias temporales de los archivos transferidos a sus nombres dados.

Código devuelto Descripción
S_OK**
Todos los archivos transferidos correctamente.
DO_E_INVALID_STATE
En el caso de las descargas, el estado del trabajo no se puede BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED.
En el caso de las cargas, el estado del trabajo debe ser BG_JOB_STATE_TRANSFERRED.

Comentarios

Todos los archivos se han transferido correctamente si el estado del trabajo es BG_JOB_STATE_TRANSFERRED. Para comprobar el estado del trabajo, llame al método IBackgroundCopyJob::GetState. También puede implementar la interfaz IBackgroundCopyCallback para recibir una notificación cuando todos los archivos se hayan transferido al cliente.

Optimización de distribución conserva los trabajos que son inferiores a 30 días. Se quitarán todos los trabajos anteriores. Optimización de distribución no admite el directiva de grupo JobInactivityTimeout.

Para los trabajos de descarga, puede llamar al método Complete en cualquier momento durante el proceso de transferencia. sin embargo, solo se guardan los archivos que se transfirieron correctamente al cliente antes de llamar a este método. Por ejemplo, si llama al método Complete mientras Optimización de distribución procesa el tercero de cinco archivos, solo se guardan los dos primeros archivos. Para determinar qué archivos se han transferido, llame al método IBackgroundCopyFile::GetProgress y compare el miembro BytesTransferred con el miembro BytesTotal de la BG_FILE_PROGRESS estructura.

Para los trabajos de carga, puede llamar al método Complete solo cuando el estado del trabajo es BG_JOB_STATE_TRANSFERRED.

El propietario del archivo es el usuario que realizó la llamada. Por ejemplo, si un administrador completa el trabajo de otra persona, el administrador no es el propietario del trabajo.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows 10, solo aplicaciones de escritorio de la versión 1709 []
Servidor mínimo compatible
Windows Servidor, solo aplicaciones de escritorio de la versión 1709 []
Encabezado
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
Biblioteca
Dosvc.lib
Archivo DLL
Dosvc.dll
IID
IID_IBackgroundCopyJob se define como 37668D37-507E-4160-9316-26306D150B12

Consulte también

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::GetState