Interface IBackgroundCopyJob
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 |
|
| IDL |
|
| Biblioteca |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob é definido como 37668D37-507E-4160-9316-26306D150B12 |