IBackgroundCopyJob::Complete method

Ends the job and saves the transferred files on the client.

Syntax

HRESULT Complete();

Parameters

This method has no parameters.

Return value

This method returns the following HRESULT values. The method can also return errors related to renaming the temporary copies of the transferred files to their given names.

Remarks

All of the files have been successfully transferred if the job's state is BG_JOB_STATE_TRANSFERRED. To check the state of the job, call the IBackgroundCopyJob::GetState method. You can also implement the IBackgroundCopyCallback interface to receive notification when all of the files have been transferred to the client.

Delivery Optimization retains jobs that are less than 30 days only. All older jobs will be removed. Delivery Optimization does not support the JobInactivityTimeout Group Policy.

For download jobs, you can call the Complete method at anytime during the transfer process; however, only files that were successfully transferred to the client before calling this method are saved. For example, if you call the Complete method while Delivery Optimization is processing the third of five files, only the first two files are saved. To determine which files have been transferred, call the IBackgroundCopyFile::GetProgress method and compare the BytesTransferred member to the BytesTotal member of the BG_FILE_PROGRESS structure.

For upload jobs, you can call the Complete method only when the job's state is BG_JOB_STATE_TRANSFERRED.

The owner of the file is the user who made the call. For example, if an administrator completes someone else's job, the administrator not the owner of the job owns the file.

Requirements

See also

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::GetState