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