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 |
|---|---|
|
Todos os arquivos transferidos com êxito. |
|
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 |
|
| IDL |
|
| Biblioteca |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob é definido como 37668D37-507E-4160-9316-26306D150B12 |