指定要包含来自服务器应用程序的回复数据的文件的名称。 仅当作业的类型 BG_JOB_TYPE_UPLOAD_REPLY时调用此方法。
Syntax
HRESULT SetReplyFileName(
[in] LPCWSTR ReplyFileName
);
参数
[in] ReplyFileName
包含回复文件的完整路径的以 Null 结尾的字符串。 如果 ReplyFileNamePathSpec 为 NULL 或空字符串，则 BITS 将生成文件名。 不能在路径或文件名中使用通配符，并且路径中的目录必须存在。 路径限制为MAX_PATH，不包括 null 终止符。 用户必须具有写入目录的权限。 BITS 不支持 NTFS 流。 不使用特定于会话的网络驱动器，而是使用 UNC 路径（例如 \server\share\path\file）。 不包括 \？ 路径中的前缀。
返回值
此方法返回以下 HRESULT 值以及其他值。
| 返回代码 | Description |
|---|---|
|
已成功指定文件的名称以包含答复数据。 |
|
BITS 开始将回复传输到客户端后，无法更改回复文件名。 如果状态BG_JOB_STATE_TRANSFERRING且BG_JOB_REPLY_PROGRESS结构的 BytesTotal成员未BG_SIZE_UNKNOWN，则 BITS 正在将回复传输到客户端。 |
|
用户无权写入客户端上的指定目录。 |
|
回复文件名无效或超过 MAX_PATH。 |
注解
如果在首次调用 IBackgroundCopyJob：：Resume 方法之前未调用 SetReplyFileName 方法，则 BITS 将生成文件名。
如果 BITS 生成文件名，则答复文件将写入与本地上传文件相同的目录。
可以在 BITS 开始从服务器应用程序下载回复之前随时调用 SetReplyFileName 方法;如果下载已开始，此方法将失败。
调用 IBackgroundCopyJob：：Complete 方法后，客户端可以使用回复文件。 若要在调用 Complete 方法之前检索回复数据，请调用 IBackgroundCopyJob2：：GetReplyData 方法。
如果服务器应用程序未提供回复，则该文件为空。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 支持的最低服务器 | Windows Server 2003 |
| 目标平台 | Windows操作系统 |
| Header | bits1_5.h （包括 Bits.h） |
| Library | Bits.lib |
| DLL | BitsPrx2.dll |
| 可再发行组件 | Windows XP 上的 BITS 1.5 |