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 值以及其他值。

返回代码 说明
S_OK
 已成功指定包含回复数据的文件的名称。
BG_E_INVALID_STATE
 在 BITS 开始将回复传输到客户端后，无法更改回复文件名。 如果状态为BG_JOB_STATE_TRANSFERRING且未BG_SIZE_UNKNOWNBG_JOB_REPLY_PROGRESS结构的 BytesTotal 成员，则 BITS 会将答复传输到客户端。
E_ACCESSDENIED
 用户没有权限写入客户端上的指定目录。
E_INVALIDARG
 回复文件名无效或超过 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

另请参阅

IBackgroundCopyJob：：GetReplyData

IBackgroundCopyJob：：GetReplyFileName