IBackgroundCopyJob2：：SetReplyFileName 方法 (bits1_5.h)

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

語法

HRESULT SetReplyFileName(
  [in] LPCWSTR ReplyFileName
);

參數

[in] ReplyFileName

包含回復檔案完整路徑的 Null 終止字串。 如果 ReplyFileNamePathSpec 為 NULL 或空字串，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