IBackgroundCopyJob2::GetReplyFileName 方法 (bits1_5.h)

从服务器应用程序检索包含回复数据的文件的名称。 仅当作业类型为BG_JOB_TYPE_UPLOAD_REPLY时才调用此方法。

语法

HRESULT GetReplyFileName(
  [out] LPWSTR *pReplyFileName
);

参数

[out] pReplyFileName

包含回复文件的完整路径的以 Null 结尾的字符串。 完成后,调用 CoTaskMemFree 函数以释放 pReplyFileName

返回值

此方法返回以下 HRESULT 值以及其他值。

返回代码 说明
S_OK
已成功检索包含回复数据的文件的名称。
E_NOTIMPL
对于 BG_JOB_TYPE_DOWNLOADBG_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)
Library Bits.lib
DLL BitsPrx2.dll
可再发行组件 Windows XP 上的 BITS 1.5

另请参阅

IBackgroundCopyJob2::GetReplyData

IBackgroundCopyJob2::SetReplyFileName