Interface IBackgroundCopyJob (bits.h)
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 parar 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 .
Herança
A interface IBackgroundCopyJob herda da interface IUnknown . IBackgroundCopyJob também tem estes tipos de membros:
Métodos
A interface IBackgroundCopyJob tem esses métodos.
| IBackgroundCopyJob::AddFile Adiciona um único arquivo ao trabalho. |
| IBackgroundCopyJob::AddFileSet Adiciona vários arquivos a um trabalho. |
| IBackgroundCopyJob::Cancel Exclui o trabalho da fila de transferência e remove arquivos temporários relacionados do cliente (downloads) e do servidor (uploads). |
| IBackgroundCopyJob::Complete Encerra o trabalho e salva os arquivos transferidos no cliente. |
| IBackgroundCopyJob::EnumFiles Recupera um ponteiro de interface IEnumBackgroundCopyFiles que você usa para enumerar os arquivos em um trabalho. |
| IBackgroundCopyJob::GetDescription Recupera a descrição do trabalho. |
| IBackgroundCopyJob::GetDisplayName Recupera o nome de exibição do trabalho. Normalmente, você usa o nome de exibição para identificar o trabalho em uma interface do usuário. |
| IBackgroundCopyJob::GetError Recupera a interface de erro após ocorrer um erro. |
| IBackgroundCopyJob::GetErrorCount Recupera o número de vezes que o BITS tentou transferir o trabalho e ocorreu um erro. |
| IBackgroundCopyJob::GetId Recupera o identificador usado para identificar o trabalho na fila. |
| IBackgroundCopyJob::GetMinimumRetryDelay Recupera o período mínimo de tempo que o serviço aguarda após encontrar uma condição de erro transitória antes de tentar transferir o arquivo. |
| IBackgroundCopyJob::GetNoProgressTimeout Recupera o período de tempo que o serviço tenta transferir o arquivo após a ocorrência de uma condição de erro transitória. Se houver progresso, o temporizador será redefinido. |
| IBackgroundCopyJob::GetNotifyFlags Recupera os sinalizadores de notificação de evento para o trabalho. |
| IBackgroundCopyJob::GetNotifyInterface Recupera o ponteiro da interface para a implementação da interface IBackgroundCopyCallback. |
| IBackgroundCopyJob::GetOwner Recupera a identidade do proprietário do trabalho. |
| IBackgroundCopyJob::GetPriority Recupera o nível de prioridade do trabalho. O nível de prioridade determina quando o trabalho é processado em relação a outros trabalhos na fila de transferência. |
| IBackgroundCopyJob::GetProgress Recupera informações de progresso relacionadas ao trabalho, como o número de bytes e arquivos transferidos. |
| IBackgroundCopyJob::GetProxySettings Recupera as informações de proxy que o trabalho usa para transferir os arquivos. |
| IBackgroundCopyJob::GetState Recupera o estado do trabalho. |
| IBackgroundCopyJob::GetTimes Recupera carimbos de data/hora relacionados ao trabalho, como a hora em que o trabalho foi criado ou modificado pela última vez. |
| IBackgroundCopyJob::GetType Recupera o tipo de transferência que está sendo executada, como um download ou upload de arquivo. |
| IBackgroundCopyJob::Resume Ativa um novo trabalho ou reinicia um trabalho que foi suspenso. |
| IBackgroundCopyJob::SetDescription Fornece uma descrição do trabalho. |
| IBackgroundCopyJob::SetDisplayName Especifica um nome de exibição para o trabalho. Normalmente, você usa o nome de exibição para identificar o trabalho em uma interface do usuário. |
| IBackgroundCopyJob::SetMinimumRetryDelay Define o período mínimo de tempo que o BITS aguarda depois de encontrar uma condição de erro transitória antes de tentar transferir o arquivo. |
| IBackgroundCopyJob::SetNoProgressTimeout Define o período de tempo que o BITS tenta transferir o arquivo após a ocorrência de uma condição de erro transitória. Se houver progresso, o temporizador será redefinido. |
| IBackgroundCopyJob::SetNotifyFlags Especifica o tipo de notificação de evento que você deseja receber, como eventos transferidos do trabalho. |
| IBackgroundCopyJob::SetNotifyInterface Identifica a implementação da interface IBackgroundCopyCallback para BITS. Use a interface IBackgroundCopyCallback para receber notificação de eventos relacionados ao trabalho. |
| IBackgroundCopyJob::SetPriority Especifica o nível de prioridade do trabalho. O nível de prioridade determina quando seu trabalho é processado em relação a outros trabalhos na fila de transferência. |
| IBackgroundCopyJob::SetProxySettings Especifica qual proxy usar para transferir arquivos. |
| IBackgroundCopyJob::Suspend Suspende um trabalho. Novos trabalhos, trabalhos que estão com erro e trabalhos que terminaram de transferir arquivos são suspensos automaticamente. |
| IBackgroundCopyJob::TakeOwnership Altera a propriedade do trabalho para o usuário atual. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP |
| Servidor mínimo com suporte | Windows Server 2003 |
| Plataforma de Destino | Windows |
| Cabeçalho | bits.h |