IBackgroundCopyJob：：GetErrorCount 方法 (bits.h)

擷取 BITS 嘗試傳輸作業和發生錯誤的次數。

語法

HRESULT GetErrorCount(
  [out] ULONG *Errors
);

參數

[out] Errors

BITS 嘗試傳輸作業時發生的錯誤數目。 當作業從BG_JOB_STATE_TRANSFERRING狀態移至BG_JOB_STATE_TRANSIENT_ERROR或BG_JOB_STATE_ERROR狀態時，計數就會增加。

傳回值

此方法會在成功時傳回 S_OK ，或錯誤時傳回其中一個標準 COM HRESULT 值。

備註

計數永遠不會重設。 計數可能不會正確反映作業移至暫時性錯誤或錯誤狀態的次數。 例如，BITS 不會在發生網路中斷連線時增加計數、檢查磁碟程序執行，或頻寬原則會防止作業傳輸。

BITS 也會在每次嘗試在作業處於暫時性錯誤狀態且作業失敗時傳送作業時，增加計數。

BITS 1.5 和更早版本： BITS 不會在每次嘗試在作業處於暫時性錯誤狀態時增加計數。

規格需求

另請參閱

IBackgroundCopyJob：：GetError