IBackgroundCopyCallback::JobError-Methode
Übermittlungsoptimierung ruft Ihre Implementierung der JobError-Methode auf, wenn sich der Status des Auftrags in BG_JOB_STATE_ERROR.
Syntax
HRESULT JobError(
[in] IBackgroundCopyJob *pJob,
[in] IBackgroundCopyError *pError
);
Parameter
-
pJob [ In]
-
Enthält auftragsbezogene Informationen, z. B. die Anzahl der Bytes und Dateien, die vor dem Fehler übertragen wurden. Sie enthält auch die Methoden zum Fortsetzen und Abbrechen des Auftrags. Geben Sie pJob nicht frei. Übermittlungsoptimierung gibt die Schnittstelle frei, wenn die JobError-Methode zurückgegeben wird.
-
pError [ In]
-
Enthält Fehlerinformationen, z. B. die Datei, die zum Zeitpunkt des schwerwiegenden Fehlers verarbeitet wird, und eine Beschreibung des Fehlers. Geben Sie pError nicht frei. Übermittlungsoptimierung gibt die Schnittstelle frei, wenn die JobError-Methode zurückgegeben wird.
Rückgabewert
Diese Methode sollte S_OK; Andernfalls Übermittlungsoptimierung diese Methode weiterhin auf, bis S_OK zurückgegeben wird. Aus Leistungsgründen sollten Sie die Anzahl der Rückgaben eines anderen Werts als S_OK auf einige Male beschränken. Als Alternative zur Rückgabe eines Fehlercodes sollten Sie in Erwägung ziehen, immer S_OK Fehler zurück S_OK und den Fehler intern zu behandeln. Das Intervall, in dem diese Methode aufgerufen wird, ist willkürlich.
Bemerkungen
Nachdem Sie die Ursache des Fehlers ermittelt haben, führen Sie eine der folgenden Optionen aus:
- Rufen Sie zum Abbrechen des Auftrags die IBackgroundCopyJob::Cancel-Methode auf.
- Um den Teil des Auftrags zu akzeptieren, der vor dem Fehler erfolgreich übertragen wurde, rufen Sie die IBackgroundCopyJob::Complete-Methode auf. Diese Option gilt nicht für Uploadaufträge. Sie können einen Teil eines Uploadauftrags nicht abschließen.
- Beheben Sie das Problem, und rufen Sie dann die IBackgroundCopyJob::Resume-Methode auf, um die Verarbeitung des Auftrags zu beenden.
Vorübergehende Fehler generieren keine Aufrufe der JobError-Methode.
Übermittlungsoptimierung gibt BG_ERROR_CONTEXT_REMOTE_FILE zurück, wenn für den Auftrag ein HTTP 403-Fehler aufgetreten ist, BG_ERROR_CONTEXT_NONE andernfalls .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 10 Desktop-Apps, Version 1709 [] |
| Unterstützte Mindestversion (Server) |
Windows Server, version 1709 desktop apps only (Nur [ Desktop-Apps der Version 1709)] |
| Header |
|
| IDL |
|
| Bibliothek |
|
| DLL |
|
| IID |
IID_IBackgroundCopyCallback ist als 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22 definiert. |