Compartilhar via


Interface IBackgroundCopyError (bits.h)

Use o
Interface IBackgroundCopyError para determinar a causa de um erro e se o processo de transferência pode continuar.

O BITS cria um objeto de erro somente quando o estado do trabalho é BG_JOB_STATE_ERROR ou BG_JOB_STATE_TRANSIENT_ERROR. O BITS não cria um objeto de erro quando um método de interface IBackgroundCopyXXXXX falha. O objeto de erro está disponível até que o BITS comece a transferir dados (o estado do trabalho muda para BG_JOB_STATE_TRANSFERRING) para o trabalho ou até que seu aplicativo seja encerrado.

Para obter um objeto IBackgroundCopyError , chame o método IBackgroundCopyJob::GetError .

Herança

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

Métodos

A interface IBackgroundCopyError tem esses métodos.

 
IBackgroundCopyError::GetError

Recupera o código de erro e identifica o contexto no qual o erro ocorreu.
IBackgroundCopyError::GetErrorContextDescription

Recupera a descrição do contexto no qual o erro ocorreu.
IBackgroundCopyError::GetErrorDescription

Recupera o texto de erro associado ao erro.
IBackgroundCopyError::GetFile

Recupera um ponteiro de interface para o objeto de arquivo associado ao erro.
IBackgroundCopyError::GetProtocol

Recupera o protocolo usado para transferir o arquivo. O nome do arquivo remoto identifica o protocolo a ser usado para transferir o arquivo.

Requisitos

   
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Plataforma de Destino Windows
Cabeçalho bits.h

Confira também

BG_JOB_STATE

IBackgroundCopyCallback::JobError

IBackgroundCopyJob::GetError

IBackgroundCopyJob::GetState

IBackgroundCopyManager::GetErrorDescription