Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft die Fehlerschnittstelle ab, nachdem ein Fehler auftritt.
BITS generiert ein Fehlerobjekt, wenn der Status des Auftrags BG_JOB_STATE_ERROR oder BG_JOB_STATE_TRANSIENT_ERROR ist. Der Dienst erstellt kein Fehlerobjekt, wenn ein Aufruf einer IBackgroundCopyXXXX-Schnittstellenmethode fehlschlägt. Das Fehlerobjekt ist verfügbar, bis BITS mit dem Übertragen von Daten (dem Status des Auftragsänderungen an BG_JOB_STATE_TRANSFERRING) für den Auftrag oder bis zum Beenden der Anwendung beginnt.
Syntax
HRESULT GetError(
[out] IBackgroundCopyError **ppError
);
Die Parameter
[out] ppError
Fehlerschnittstelle, die den Fehlercode, eine Beschreibung des Fehlers und den Kontext bereitstellt, in dem der Fehler aufgetreten ist. Dieser Parameter identifiziert auch die Datei, die beim Auftreten des Fehlers übertragen wird. Lassen Sie ppError frei, wenn Sie fertig sind.
Rückgabewert
Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.
| Rückgabecode | Description |
|---|---|
|
Das Fehlerobjekt wurde erfolgreich generiert. |
|
Die Fehlerschnittstelle ist erst verfügbar, nachdem ein Fehler aufgetreten ist (BG_JOB_STATE_ERROR oder BG_JOB_STATE_TRANSIENT_ERROR), und bevor BITS mit der Übertragung von Daten beginnt (BG_JOB_STATE_TRANSFERRING). |
Bemerkungen
Der Auftrag wird bei schwerwiegenden Fehlern oder nach Ablauf des Zeitraums ohne Fortschritt für vorübergehende Fehler in einen Fehlerzustand versetzt (dieser Zeitraum wird aus der GetNoProgressTimeout-Methode abgerufen). Verwenden Sie eine der folgenden Optionen, um zu ermitteln, ob der Auftrag fehlerhaft ist:
- Rufen Sie zum Abrufen des Auftragsstatus die IBackgroundCopyJob::GetState-Methode auf. Der Auftrag ist fehlerhaft, wenn der Zustand BG_JOB_STATE_ERROR ist.
- Um Benachrichtigungen zu erhalten, wenn ein Fehler auftritt, implementieren Sie die IBackgroundCopyCallback-Schnittstelle (insbesondere die JobError-Methode ). Rufen Sie dann die IBackgroundCopyJob::SetNotifyInterface-Methode auf, um den Rückruf und die IBackgroundCopyJob::SetNotifyFlags-Methode zu registrieren, um das BG_NOTIFY_JOB_ERROR Flag festzulegen.
- Rufen Sie zum Abbrechen des Auftrags die IBackgroundCopyJob::Cancel-Methode auf.
- Rufen Sie die IBackgroundCopyJob::Complete-Methode auf, um die Dateien zu speichern, die erfolgreich vor dem Fehler übertragen wurden.
- Um die Verarbeitung des Auftrags abzuschließen, beheben Sie das Problem, und rufen Sie dann die IBackgroundCopyJob::Resume-Methode auf.
Um festzustellen, ob der Upload-, Antwort- oder Serveranwendungsteil eines Uploadantwortauftrags fehlgeschlagen ist, rufen Sie die IBackgroundCopyError::GetError-Methode auf, um den Kontext abzurufen, in dem der Fehler aufgetreten ist. Fehler bei der Serveranwendung, wenn der Kontext BG_ERROR_CONTEXT_REMOTE_APPLICATION ist. Wenn sich der Fehler mit dem Upload oder der Antwort befindet, wird der Kontext BG_ERROR_CONTEXT_REMOTE_FILE. Fehler beim Hochladen, wenn das BytesTotal-Element der BG_JOB_REPLY_PROGRESS Struktur BG_SIZE_UNKNOWN ist. Andernfalls ist die Antwort fehlgeschlagen.
Examples
Weitere Informationen finden Sie im Beispielcode im Thema "Fehlerbehandlung" .
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows XP |
| Mindestanforderungen für unterstützte Server | Windows Server 2003 |
| Zielplattform | Fenster |
| Header | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |