IBackgroundCopyJob2::GetReplyFileName 方法 (bits1_5.h)
从服务器应用程序检索包含回复数据的文件的名称。 仅当作业类型为BG_JOB_TYPE_UPLOAD_REPLY时才调用此方法。
语法
HRESULT GetReplyFileName(
[out] LPWSTR *pReplyFileName
);
参数
[out] pReplyFileName
包含回复文件的完整路径的以 Null 结尾的字符串。 完成后,调用 CoTaskMemFree 函数以释放 pReplyFileName 。
返回值
此方法返回以下 HRESULT 值以及其他值。
返回代码 | 说明 |
---|---|
|
已成功检索包含回复数据的文件的名称。 |
|
对于 BG_JOB_TYPE_DOWNLOAD 或 BG_JOB_TYPE_UPLOAD 类型的作业,不实现此方法。 |
注解
若要指定回复文件名,请调用 IBackgroundCopyJob2::SetReplyFileName 方法。 如果未指定名称, GetReplyFileName 方法将返回 BITS 为你生成的名称。 如果未指定名称,并在将文件添加到作业之前调用此方法, 则 pReplyFileName 设置为 NULL。
在打开和读取回复文件之前,必须调用 IBackgroundCopyJob::Complete 方法;在调用 Complete 方法之前,回复文件对客户端不可用。
如果服务器应用程序未提供答复,则文件为空。
示例
有关使用 GetReplyFileName 方法的示例,请参阅 从 Upload-Reply 作业检索答复。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2003 |
目标平台 | Windows |
标头 | bits1_5.h (包括 Bits.h) |
Library | Bits.lib |
DLL | BitsPrx2.dll |
可再发行组件 | Windows XP 上的 BITS 1.5 |