IBackgroundCopyFile3::GetTemporaryName 方法 (bits3_0.h)
取得包含下載內容之臨時檔的完整路徑。
語法
HRESULT GetTemporaryName(
[out] LPWSTR *pFilename
);
參數
[out] pFilename
包含臨時檔完整路徑的 Null 終止字串。 完成時,呼叫 CoTaskMemFree 函式以釋放 ppFileName 。
傳回值
方法會傳回下列傳回值。
傳回碼 | 描述 |
---|---|
|
Success |
備註
應用程式可以使用此方法,在作業完成之前取得數據的存取權。 開啟檔案以進行共用寫入存取 (FILE_SHARE_WRITE) 。 若要判斷已傳輸的位元組數目,並可供讀取,請呼叫 IBackgroundCopyFile::GetProgress 方法。 請注意,如果 URL 的時間戳變更,進度資訊將會設定回零。
在 BITS 開始傳輸檔案之前,請勿開啟檔案以供讀取;否則,作業會進入暫時性錯誤狀態。
暫存盤可供使用,直到應用程式呼叫 IBackgroundCopyJob::Complete 或 IBackgroundCopyJob::Cancel 方法,或 JobInactivityTimeout 組策略到期為止。 您必須先釋放暫存盤的句柄,才能呼叫 Complete 或 Cancel 方法。
呼叫 Complete 時,暫存盤的 ACL 與最後一個檔案的 ACL 相同, (ACL 繼承自資料夾) 。
若要判斷 BITS 是否已完成傳輸檔案,您可以:
- 呼叫 IBackgroundCopyFile::GetProgress 方法,並比較 BytesTransferred 與 BytesTotal。
- 實作 IBackgroundCopyCallback2::FileTransferred 回呼 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | bits3_0.h (包含 Bits.h) |
程式庫 | Bits.lib |