Interfaz IBackgroundCopyError (bits.h)

Artículo
03/14/2023

Use el
Interfaz IBackgroundCopyError para determinar la causa de un error y si el proceso de transferencia puede continuar.

BITS crea un objeto de error solo cuando el estado del trabajo es BG_JOB_STATE_ERROR o BG_JOB_STATE_TRANSIENT_ERROR. BITS no crea un objeto de error cuando se produce un error en un método de interfaz IBackgroundCopyXXXX . El objeto de error está disponible hasta que BITS comienza a transferir datos (el estado del trabajo cambia a BG_JOB_STATE_TRANSFERRING) para el trabajo o hasta que se cierra la aplicación.

Para obtener un objeto IBackgroundCopyError , llame al método IBackgroundCopyJob::GetError .

Herencia

La interfaz IBackgroundCopyError hereda de la interfaz IUnknown . IBackgroundCopyError también tiene estos tipos de miembros:

Métodos

La interfaz IBackgroundCopyError tiene estos métodos.


IBackgroundCopyError::GetError Recupera el código de error e identifica el contexto en el que se produjo el error.
IBackgroundCopyError::GetErrorContextDescription Recupera la descripción del contexto en el que se produjo el error.
IBackgroundCopyError::GetErrorDescription Recupera el texto del error asociado al error.
IBackgroundCopyError::GetFile Recupera un puntero de interfaz al objeto de archivo asociado al error.
IBackgroundCopyError::GetProtocol Recupera el protocolo utilizado para transferir el archivo. El nombre de archivo remoto identifica el protocolo que se va a usar para transferir el archivo.