IBackgroundCopyError-Schnittstelle
Verwenden Sie die IBackgroundCopyError-Schnittstelle , um die Ursache eines Fehlers zu ermitteln und ob der Übertragungsprozess fortgesetzt werden kann.
Die Übermittlungsoptimierung erstellt ein Fehlerobjekt nur, wenn der Status des Auftrags BG_JOB_STATE_ERROR oder BG_JOB_STATE_TRANSIENT_ERROR ist. Die Übermittlungsoptimierung erstellt kein Fehlerobjekt, wenn eine IBackgroundCopyXXXX-Schnittstellenmethode fehlschlägt. Das Fehlerobjekt ist verfügbar, bis die Übermittlungsoptimierung mit der Übertragung von Daten beginnt (der Status des Auftrags ändert sich in BG_JOB_STATE_TRANSFERRING) für den Auftrag.
Um ein IBackgroundCopyError-Objekt abzurufen, rufen Sie die IBackgroundCopyJob::GetError-Methode auf.
Member
Die IBackgroundCopyError-Schnittstelle erbt von der IUnknown-Schnittstelle . IBackgroundCopyError verfügt auch über die folgenden Typen von Membern:
Methoden
Die IBackgroundCopyError-Schnittstelle verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| GetError | Ruft den Fehlercode ab und identifiziert den Kontext, in dem der Fehler aufgetreten ist. |
| Getfile | Ruft einen Schnittstellenzeiger auf das dem Fehler zugeordnete Dateiobjekt ab. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 10, Version 1709 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server, Version 1709 [nur Desktop-Apps] |
| Header |
|
| IDL |
|
| Bibliothek |
|
| DLL |
|
| IID |
IID_IBackgroundCopyError ist definiert als 19C613A0-FCB8-4F28-81AE-897C3D078F81 |