共用方式為


IBackgroundCopyJob2::SetReplyFileName 方法 (bits1_5.h)

指定要包含伺服器應用程式之回復資料的檔名。 只有在作業的類型 BG_JOB_TYPE_UPLOAD_REPLY時,才呼叫這個方法。

語法

HRESULT SetReplyFileName(
  [in] LPCWSTR ReplyFileName
);

參數

[in] ReplyFileName

包含回復檔案完整路徑的 Null 終止字串。 如果 ReplyFileNamePathSpecNULL 或空字串,BITS 會產生檔名。 您無法在路徑或檔名中使用通配符,而且路徑中的目錄必須存在。 路徑限制為MAX_PATH,不包括 Null 終止符。 用戶必須具有寫入目錄的許可權。 BITS 不支援NTFS資料流。 例如,\server\share\path\file) (,而不是使用會話特定的網路驅動器機。 不要包含 \? 路徑中的前置詞。

傳回值

這個方法會傳回下列 HRESULT 值,以及其他值。

傳回碼 Description
S_OK
已成功指定包含回復數據的檔名。
BG_E_INVALID_STATE
在 BITS 開始傳送回覆給客戶端之後,您無法變更回覆檔名。 如果狀態為BG_JOB_STATE_TRANSFERRING,而且BG_JOB_REPLY_PROGRESS結構的 BytesTotal 成員未BG_SIZE_UNKNOWN,BITS 會傳送回復給用戶端。
E_ACCESSDENIED
用戶沒有寫入用戶端上指定目錄的許可權。
E_INVALIDARG
回復檔名無效或超過 MAX_PATH

備註

如果您第一次呼叫 IBackgroundCopyJob::Resume 方法之前未呼叫 SetReplyFileName 方法,BITS 會產生檔名。

如果 BITS 產生檔名,回覆檔案會寫入與本機上傳檔案相同的目錄。

您可以在 BITS 開始從伺服器應用程式下載回復之前,隨時呼叫 SetReplyFileName 方法;如果已開始下載,方法就會失敗。

呼叫 IBackgroundCopyJob::Complete 方法之後,用戶端可以使用回復檔案。 若要在呼叫 Complete 方法之前擷取回復數據,請呼叫 IBackgroundCopyJob2::GetReplyData 方法。

如果伺服器應用程式未提供回復,則檔案是空的。

規格需求

需求
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2003
目標平台 Windows
標頭 bits1_5.h (包含 Bits.h)
程式庫 Bits.lib
Dll BitsPrx2.dll
可轉散發套件 Windows XP 上的 BITS 1.5

另請參閱

IBackgroundCopyJob::GetReplyData

IBackgroundCopyJob::GetReplyFileName