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:

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
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
Bibliothek
Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyCallback ist als 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22 definiert.

Weitere Informationen

IBackgroundCopyCallback

IBackgroundCopyError

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::Resume