IBackgroundCopyJob2::GetReplyFileName 方法 (bits1_5.h)
從伺服器應用程式擷取包含回復數據的檔名。 只有在作業類型為BG_JOB_TYPE_UPLOAD_REPLY時,才呼叫此方法。
語法
HRESULT GetReplyFileName(
[out] LPWSTR *pReplyFileName
);
參數
[out] pReplyFileName
Null 終止的字串,其中包含回復檔案的完整路徑。 完成時呼叫 CoTaskMemFree 函式以釋放 pReplyFileName 。
傳回值
這個方法會傳回下列 HRESULT 值,以及其他值。
傳回碼 | Description |
---|---|
|
已成功擷取包含回復數據的檔名。 |
|
這個方法不會針對類型 為 BG_JOB_TYPE_DOWNLOAD 或 BG_JOB_TYPE_UPLOAD的作業實 作。 |
備註
若要指定回復檔名,請呼叫 IBackgroundCopyJob2::SetReplyFileName 方法。 如果您未指定名稱, GetReplyFileName 方法會傳回為您產生的 BITS 名稱。 如果您未指定名稱,而且您在將檔案新增至作業之前呼叫此方法, pReplyFileName 會設定為 NULL。
您必須先呼叫 IBackgroundCopyJob::Complete 方法,才能開啟和讀取回復檔案;在您呼叫 Complete 方法之前,客戶端無法使用回覆檔案。
如果伺服器應用程式未提供回復,則檔案是空的。
範例
如需使用 GetReplyFileName 方法的範例,請參閱 從 Upload-Reply 作業擷取回復。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2003 |
目標平台 | Windows |
標頭 | bits1_5.h (包含 Bits.h) |
程式庫 | Bits.lib |
Dll | BitsPrx2.dll |
可轉散發套件 | Windows XP 上的 BITS 1.5 |