Método IBackgroundCopyJob::Complete

Encerra o trabalho e salva os arquivos transferidos no cliente.

Sintaxe

HRESULT Complete();

Parâmetros

Esse método não tem parâmetros.

Valor retornado

Esse método retorna os seguintes valores HRESULT . O método também pode retornar erros relacionados à renomeação das cópias temporárias dos arquivos transferidos para seus nomes determinados.

Código de retorno	Descrição
S_OK	Todos os arquivos transferidos com êxito.
DO_E_INVALID_STATE	Para downloads, o estado do trabalho não pode ser BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED. Para uploads, o estado do trabalho deve ser BG_JOB_STATE_TRANSFERRED.

Comentários

Todos os arquivos foram transferidos com êxito se o estado do trabalho for BG_JOB_STATE_TRANSFERRED. Para marcar o estado do trabalho, chame o método IBackgroundCopyJob::GetState. Você também pode implementar a interface IBackgroundCopyCallback para receber notificação quando todos os arquivos forem transferidos para o cliente.

A Otimização de Entrega retém trabalhos com menos de 30 dias. Todos os trabalhos mais antigos serão removidos. A Otimização de Entrega não dá suporte à Política de Grupo JobInactivityTimeout.

Para trabalhos de download, você pode chamar o método Complete a qualquer momento durante o processo de transferência; no entanto, somente os arquivos que foram transferidos com êxito para o cliente antes de chamar esse método são salvos. Por exemplo, se você chamar o método Complete enquanto a Otimização de Entrega estiver processando o terceiro de cinco arquivos, somente os dois primeiros arquivos serão salvos. Para determinar quais arquivos foram transferidos, chame o método IBackgroundCopyFile::GetProgress e compare o membro BytesTransferred com o membro BytesTotal da estrutura BG_FILE_PROGRESS .

Para trabalhos de upload, você pode chamar o método Complete somente quando o estado do trabalho for BG_JOB_STATE_TRANSFERRED.

O proprietário do arquivo é o usuário que fez a chamada. Por exemplo, se um administrador concluir o trabalho de outra pessoa, o administrador não o proprietário do trabalho será o proprietário do arquivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server, versão 1709 [somente aplicativos da área de trabalho]
Cabeçalho	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Biblioteca	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyJob é definido como 37668D37-507E-4160-9316-26306D150B12

Confira também

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::GetState