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 |