IBackgroundCopyJob2::GetReplyFileName 方法(bits1_5.h)

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

Syntax

HRESULT GetReplyFileName(
  [out] LPWSTR *pReplyFileName
);

参数

[out] pReplyFileName

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

返回值

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

返回代码 Description
S_OK
已成功检索包含回复数据的文件的名称。
E_NOTIMPL
此方法不适用于类型 为BG_JOB_TYPE_DOWNLOADBG_JOB_TYPE_UPLOAD的作业。

注解

若要指定回复文件名,请调用 IBackgroundCopyJob2::SetReplyFileName 方法。 如果未指定名称, GetReplyFileName 方法将返回为你生成的 BITS 的名称。 如果未指定名称,并在将文件添加到作业之前调用此方法, pReplyFileName 将设置为 NULL

在打开和读取回复文件之前,必须调用 IBackgroundCopyJob::Complete 方法;在调用 Complete 方法之前,回复文件对客户端不可用。

如果服务器应用程序未提供回复,则该文件为空。

例子

有关使用 GetReplyFileName 方法的示例,请参阅 “从 Upload-Reply 作业检索回复”。

要求

Requirement 价值
最低支持的客户端 Windows Vista
支持的最低服务器 Windows Server 2003
目标平台 Windows操作系统
Header bits1_5.h (包括 Bits.h)
Library Bits.lib
DLL BitsPrx2.dll
可再发行组件 Windows XP 上的 BITS 1.5

另请参阅

IBackgroundCopyJob2::GetReplyData

IBackgroundCopyJob2::SetReplyFileName