IXtfDeployCallback::OnDeployFileProgress
叫用以回報將檔案部署至主機之進度的回呼。語法
參數
pszFilePath類型:LPCWSTR 正在部署之檔案的路徑。 ullBytesTransferred
類型:ULONGLONG 到目前為止已傳輸的位元組數目。 ullFileSize
類型:ULONGLONG 正在傳輸之檔案的總大小 (以位元組為單位)。
傳回值
類型:HRESULT 傳回S_OK 以繼續部署,或傳回 HRESULT 錯誤碼以取消部署。
備註
此回呼會在部署系統將檔案從執行部署的電腦傳輸至主機時叫用。檔案每成功傳輸一個緩衝區區塊,就會呼叫此回呼一次。每個成功傳輸的檔案一律會叫用此回呼至少兩次:一次在部署開始時,一次在部署結束時。如果部署的是長度為零的檔案,兩次叫用都會回報已傳輸零位元組 (共零位元組)。如需在部署程序期間如何評估檔案以及何時叫用回呼的詳細資訊,請參閱 IXtfDeployCallback 介面。部署的檔案傳輸程序會使用多個執行緒。您的程式碼必須確保依
pszFilePath 關聯進度訊息,並防範一般的多執行緒問題。IXtfDeployCallback 的其他回呼相同,如果此回呼傳回 S_OK,部署程序就會繼續。如果此回呼傳回任何 HRESULT 錯誤碼,部署程序就會立即取消。已傳輸或已刪除的檔案會維持原狀,而部分傳輸的檔案則會以截斷的形式關閉。必須再完成一次部署,才能確保主機上的所有檔案都完整且為最新狀態。
需求
標頭: xtfapplication.h 程式庫: xtfapplication.lib 支援的平台: Windows (適用於 XBOX 主機工具)另請參閱
IXtfDeployCallback 介面XtfApplication
