IBackgroundCopyFile3：：GetTemporaryName 方法 (bits3_0.h)

取得包含下載內容之臨時檔的完整路徑。

語法

HRESULT GetTemporaryName(
  [out] LPWSTR *pFilename
);

參數

[out] pFilename

包含臨時檔完整路徑的 Null 終止字串。 完成時，呼叫 CoTaskMemFree 函式以釋放 ppFileName 。

傳回值

方法會傳回下列傳回值。

傳回碼	描述
S_OK	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

另請參閱

IBackgroundCopyCallback2：：FileTransferred

IBackgroundCopyFile3