IBackgroundCopyCallback::JobError 方法

當作業的狀態變更為BG_JOB_STATE_ERROR時,傳遞優化會呼叫 JobError 方法的實作。

語法

HRESULT JobError(
  [in] IBackgroundCopyJob   *pJob,
  [in] IBackgroundCopyError *pError
);

參數

pJob [in]

包含作業相關資訊,例如發生錯誤之前傳輸的位元組和檔案數目。 它也包含繼續和取消作業的方法。 不要發行 pJob;傳遞優化會在 JobError 方法傳回時釋放介面。

pError [in]

包含錯誤資訊,例如在發生嚴重錯誤時正在處理的檔案,以及錯誤的描述。 不要發行 pError;傳遞優化會在 JobError 方法傳回時釋放介面。

傳回值

這個方法應該會 傳回S_OK;否則,傳遞優化會繼續呼叫這個方法,直到 傳回S_OK 為止。 基於效能考慮,您應該將傳回 S_OK以外的值 次數限制為數次。 除了傳回錯誤碼,請考慮一律傳回 S_OK 並在內部處理錯誤。 呼叫這個方法的間隔是任意的。

備註

判斷錯誤的原因之後,請執行下列其中一個選項:

暫時性錯誤不會產生 JobError 方法的呼叫。

如果作業遇到 HTTP 403 錯誤,傳遞優化會傳回BG_ERROR_CONTEXT_REMOTE_FILE否則BG_ERROR_CONTEXT_NONE。

規格需求

需求
最低支援的用戶端
Windows 10 1709 版 [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 版本 1709 [僅限傳統型應用程式]
標頭
Deliveryoptimization.h
Idl
DeliveryOptimization.idl
程式庫
Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyCallback定義為 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22

另請參閱

IBackgroundCopyCallback

IBackgroundCopyError

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::Resume