IBackgroundCopyError-Schnittstelle (bits.h)

Verwenden Sie die Schaltfläche
IBackgroundCopyError-Schnittstelle , um die Ursache eines Fehlers zu ermitteln und ob der Übertragungsvorgang fortgesetzt werden kann.

BITS erstellt nur dann ein Fehlerobjekt, wenn der Status des Auftrags BG_JOB_STATE_ERROR oder BG_JOB_STATE_TRANSIENT_ERROR ist. BITS erstellt kein Fehlerobjekt, wenn eine IBackgroundCopyXXXX-Schnittstellenmethode fehlschlägt. Das Fehlerobjekt ist verfügbar, bis BITS mit der Übertragung von Daten beginnt (der Status des Auftrags ändert sich in BG_JOB_STATE_TRANSFERRING) für den Auftrag oder bis ihre Anwendung beendet wird.

Um ein IBackgroundCopyError-Objekt abzurufen, rufen Sie die IBackgroundCopyJob::GetError-Methode auf.

Vererbung

Die IBackgroundCopyError-Schnittstelle erbt von der IUnknown-Schnittstelle . IBackgroundCopyError verfügt auch über folgende Membertypen:

Methoden

Die IBackgroundCopyError-Schnittstelle verfügt über diese Methoden.

IBackgroundCopyError::GetError Ruft den Fehlercode ab und identifiziert den Kontext, in dem der Fehler aufgetreten ist.
IBackgroundCopyError::GetErrorContextDescription Ruft die Beschreibung des Kontexts ab, in dem der Fehler aufgetreten ist.
IBackgroundCopyError::GetErrorDescription Ruft den dem Fehler zugeordneten Fehlertext ab.
IBackgroundCopyError::GetFile Ruft einen Schnittstellenzeiger auf das Dateiobjekt ab, das dem Fehler zugeordnet ist.
IBackgroundCopyError::GetProtocol Ruft das Protokoll ab, das zum Übertragen der Datei verwendet wird. Der Name der Remotedatei gibt das Protokoll an, das zum Übertragen der Datei verwendet werden soll.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Zielplattform	Windows
Kopfzeile	bits.h

Weitere Informationen

BG_JOB_STATE

IBackgroundCopyCallback::JobError

IBackgroundCopyJob::GetError

IBackgroundCopyJob::GetState

IBackgroundCopyManager::GetErrorDescription