Interfaccia IBackgroundCopyError (bits.h)

Usare il
Interfaccia IBackgroundCopyError per determinare la causa di un errore e se il processo di trasferimento può procedere.

BITS crea un oggetto errore solo quando lo stato del processo è BG_JOB_STATE_ERROR o BG_JOB_STATE_TRANSIENT_ERROR. BITS non crea un oggetto errore quando un metodo di interfaccia IBackgroundCopyXXXX ha esito negativo. L'oggetto error è disponibile fino a quando BITS inizia a trasferire i dati (lo stato del processo cambia in BG_JOB_STATE_TRANSFERRING) per il processo o fino a quando l'applicazione non viene chiusa.

Per ottenere un oggetto IBackgroundCopyError , chiamare il metodo IBackgroundCopyJob::GetError .

Ereditarietà

L'interfaccia IBackgroundCopyError eredita dall'interfaccia IUnknown . IBackgroundCopyError include anche questi tipi di membri:

Metodi

L'interfaccia IBackgroundCopyError include questi metodi.

IBackgroundCopyError::GetError Recupera il codice di errore e identifica il contesto in cui si è verificato l'errore.
IBackgroundCopyError::GetErrorContextDescription Recupera la descrizione del contesto in cui si è verificato l'errore.
IBackgroundCopyError::GetErrorDescription Recupera il testo dell'errore associato all'errore.
IBackgroundCopyError::GetFile Recupera un puntatore dell'interfaccia all'oggetto file associato all'errore.
IBackgroundCopyError::GetProtocol Recupera il protocollo usato per trasferire il file. Il nome del file remoto identifica il protocollo da usare per trasferire il file.

Requisiti

Client minimo supportato	Windows XP
Server minimo supportato	Windows Server 2003
Piattaforma di destinazione	Windows
Intestazione	bits.h

Vedi anche

BG_JOB_STATE

IBackgroundCopyCallback::JobError

IBackgroundCopyJob::GetError

IBackgroundCopyJob::GetState

IBackgroundCopyManager::GetErrorDescription