IBackgroundCopyCallback::JobError-Methode
Die Übermittlungsoptimierung ruft Ihre Implementierung der JobError-Methode auf, wenn sich der Status des Auftrags in BG_JOB_STATE_ERROR ändert.
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 Auftreten des Fehlers übertragen wurden. Außerdem enthält es die Methoden zum Fortsetzen und Abbrechen des Auftrags. Geben Sie pJob nicht frei; Die Ü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 Auftretens des schwerwiegenden Fehlers verarbeitet wird, und eine Beschreibung des Fehlers. Geben Sie pError nicht frei; Die Übermittlungsoptimierung gibt die Schnittstelle frei, wenn die JobError-Methode zurückgegeben wird.
Rückgabewert
Diese Methode sollte S_OK zurückgeben. Andernfalls ruft die Übermittlungsoptimierung diese Methode so lange 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. Alternativ zum Zurückgeben eines Fehlercodes sollten Sie immer S_OK zurückgeben und den Fehler intern behandeln. Das Intervall, in dem diese Methode aufgerufen wird, ist beliebig.
Bemerkungen
Nachdem Sie die Fehlerursache ermittelt haben, führen Sie eine der folgenden Optionen aus:
- Um den Auftrag abzubrechen, rufen Sie die IBackgroundCopyJob::Cancel-Methode auf.
- Um den Teil des Auftrags zu akzeptieren, der vor dem Auftreten des Fehlers 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.
- Um die Verarbeitung des Auftrags abzuschließen, beheben Sie das Problem, und rufen Sie dann die IBackgroundCopyJob::Resume-Methode auf.
Vorübergehende Fehler generieren keine Aufrufe der JobError-Methode .
Die Übermittlungsoptimierung gibt BG_ERROR_CONTEXT_REMOTE_FILE zurück, wenn für den Auftrag ein HTTP 403-Fehler auftritt, BG_ERROR_CONTEXT_NONE andernfalls.
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_IBackgroundCopyCallback ist definiert als 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22 |