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