Interface IBackgroundCopyJob

  • Artigo

Use a interface IBackgroundCopyJob para adicionar arquivos ao trabalho, definir o nível de prioridade do trabalho, determinar o estado do trabalho e iniciar e interromper o trabalho.

Para criar um trabalho, chame o método IBackgroundCopyManager::CreateJob . Para obter um ponteiro de interface IBackgroundCopyJob para um trabalho existente, chame o método IBackgroundCopyManager::GetJob .

Membros

A interface IBackgroundCopyJob herda da interface IUnknown . IBackgroundCopyJob também tem estes tipos de membros:

Métodos

A interface IBackgroundCopyJob tem esses métodos.

Método Descrição
Cancelar Cancela o trabalho e remove arquivos temporários do cliente.
Concluir Encerra o trabalho e salva os arquivos transferidos no cliente.
EnumFiles Retorna um ponteiro de interface para um objeto enumerador que você usa para enumerar os arquivos no trabalho.
GetDisplayName Recupera o nome de exibição que identifica o trabalho.
GetError Recupera um ponteiro de interface para o objeto de erro após ocorrer um erro.
Getid Recupera o identificador do trabalho na fila.
GetNoProgressTimeout Recupera o período de tempo que a Otimização de Entrega continua tentando transferir o arquivo depois de encontrar uma condição de erro transitória.
GetNotifyFlags Recupera os sinalizadores de notificação de evento (retorno de chamada) que você definiu para seu aplicativo.
GetNotifyInterface Recupera um ponteiro para a implementação da interface IBackgroundCopyCallback (retornos de chamada).
Getpriority Recupera o nível de prioridade definido para o trabalho.
GetProgress Recupera informações de progresso relacionadas ao trabalho, como o número de bytes e arquivos transferidos para o cliente.
GetState Recupera o estado do trabalho.
GetTimes Recupera carimbos de data/hora para atividades relacionadas ao trabalho, como a hora em que o trabalho foi criado.
Gettype Recupera o tipo de transferência que está sendo executada, como um download de arquivo.
Retomar Inicia um novo trabalho ou reinicia um trabalho suspenso.
SetNoProgressTimeout Especifica o período de tempo que a Otimização de Entrega continua tentando transferir o arquivo depois de encontrar uma condição de erro transitória.
SetNotifyFlags Especifica o tipo de notificação de evento a receber.
SetNotifyInterface Especifica um ponteiro para a implementação da interface IBackgroundCopyCallback (retornos de chamada). A interface recebe notificação com base nos sinalizadores de notificação de eventos definidos.
Setpriority Especifica a prioridade do trabalho em relação a outros trabalhos na fila de transferência.
Suspender Pausa o trabalho.

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

IBackgroundCopyFile

IBackgroundCopyManager