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 並在內部處理錯誤。 呼叫這個方法的間隔是任意的。
備註
判斷錯誤的原因之後,請執行下列其中一個選項:
- 若要取消作業,請呼叫 IBackgroundCopyJob::Cancel 方法。
- 若要接受在發生錯誤之前成功傳輸之作業的部分,請呼叫 IBackgroundCopyJob::Complete 方法。 此選項不適用於上傳作業;您無法完成上傳工作的一部分。
- 若要完成處理作業,請修正問題,然後呼叫 IBackgroundCopyJob::Resume 方法。
暫時性錯誤不會產生 JobError 方法的呼叫。
如果作業遇到 HTTP 403 錯誤,傳遞優化會傳回BG_ERROR_CONTEXT_REMOTE_FILE否則BG_ERROR_CONTEXT_NONE。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 10 1709 版 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 版本 1709 [僅限傳統型應用程式] |
標頭 |
|
Idl |
|
程式庫 |
|
DLL |
|
IID |
IID_IBackgroundCopyCallback定義為 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應