IBackgroundCopyFile2：：SetRemoteName 方法
将远程名称更改为下载作业中的新 URL。
语法
HRESULT SetRemoteName(
[in] LPCWSTR RemoteName
);
参数
-
RemoteName [in]
-
以 Null 结尾的字符串，其中包含服务器上文件的名称。 有关指定远程名称的信息，请参阅 RemoteName 成员。
返回值
此方法返回以下返回值以及其他返回值。
| 返回代码 | 说明 |
|---|---|
|
成功 |
|
新的远程名称是无效的 URL，或者新 URL 太长 (URL 不能超过 2，200 个字符) 。 |
备注
通常，如果要更改用于传输文件的 URL，或者要更改文件名或路径，则调用此方法。
此方法在返回时不序列化。 若要序列化更改， 请挂起 作业，如果更改作业中的多个文件， (调用此方法，请使用循环) ，然后 恢复 作业。 调用 IBackgroundCopyJob：：Resume 方法将序列化更改。
如果新远程名称的时间戳或文件大小与以前的远程名称不同，或者新服务器不支持 HTTP 远程名称) 的检查点恢复 (，则传递优化将重启下载。 否则，传输将从新服务器上的相同位置恢复。 传递优化不会重启已传输的文件。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 10版本 1709 [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 版本 1709 [仅限桌面应用] |
| 标头 |
|
| IDL |
|
| 库 |
|
| DLL |
|
| IID |
IID_IBackgroundCopyFile2定义为 83e81b93-0873-474d-8a8c-f2018b1a939c |