IBackgroundCopyJob2：：GetReplyFileName 方法 (bits1_5.h)

  • 發行項

從伺服器應用程式擷取包含回復數據的檔名。 只有在作業類型為BG_JOB_TYPE_UPLOAD_REPLY時，才呼叫此方法。

語法

HRESULT GetReplyFileName(
  [out] LPWSTR *pReplyFileName
);

參數

[out] pReplyFileName

Null 終止的字串，其中包含回復檔案的完整路徑。 完成時呼叫 CoTaskMemFree 函式以釋放 pReplyFileName 。

傳回值

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

傳回碼 Description
S_OK
 已成功擷取包含回復數據的檔名。
E_NOTIMPL
 這個方法不會針對類型 為 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

另請參閱

IBackgroundCopyJob2：：GetReplyData

IBackgroundCopyJob2：：SetReplyFileName