共用方式為


IBackgroundCopyCallback2::FileTransferred 方法 (bits3_0.h)

BITS 會在 BITS 成功完成傳輸檔案時,呼叫 FileTransferred 方法的實作。

語法

HRESULT FileTransferred(
  [in] IBackgroundCopyJob  *pJob,
  [in] IBackgroundCopyFile *pFile
);

參數

[in] pJob

包含作業相關信息。 不要發行 pJob;當這個方法傳回時,BITS 會釋放介面。

[in] pFile

包含檔案相關信息。 不要釋放 pFile;當這個方法傳回時,BITS 會釋放介面。

傳回值

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

備註

一般而言,除非您想要驗證已下載之檔案的內容,否則不會使用此回呼。 如果您要下載可提供給對等的內容,驗證檔案可能很重要。

若要取得包含已下載內容的臨時檔名稱,請呼叫 IBackgroundCopyFile3::GetTemporaryName 方法。 驗證內容之後,呼叫 IBackgroundCopyFile3::SetValidationState 方法,以在檔案的內容有效時向BITS指出。 如果您將驗證狀態設定為 FALSE ,且內容來自源伺服器,則作業會移至錯誤狀態。

如果內容來自對等,BITS 會從源伺服器下載檔。 從源伺服器傳輸檔完成之後,會再次呼叫回呼。

BITS 3.0: 從源伺服器傳輸檔完成之後,不會再次呼叫回呼。

針對作業, FileTransferred 回呼會串行化。 在目前的回呼成功傳回之前,BITS 不會分派作業中下一個檔案的回呼。

FileTransferred 回呼會在 JobTransferredJobError 回呼之前分派。

FileTransferred 回呼適用於下載作業或上傳-回復作業的回復部分。

規格需求

需求
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 bits3_0.h (包含 Bits.h)
程式庫 Bits.lib

另請參閱

IBackgroundCopyCallback

IBackgroundCopyCallback2