检索包含服务器应用程序中答复数据的文件的名称。 仅当作业类型BG_JOB_TYPE_UPLOAD_REPLY时调用此方法。
Syntax
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 作业检索回复”。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 支持的最低服务器 | Windows Server 2003 |
| 目标平台 | Windows操作系统 |
| Header | bits1_5.h (包括 Bits.h) |
| Library | Bits.lib |
| DLL | BitsPrx2.dll |
| 可再发行组件 | Windows XP 上的 BITS 1.5 |