IBackgroundCopyFile2：：SetRemoteName 方法

将远程名称更改为下载作业中的新 URL。

语法

HRESULT SetRemoteName(
  [in] LPCWSTR RemoteName
);

RemoteName [in]: 以 Null 结尾的字符串，其中包含服务器上文件的名称。有关指定远程名称的信息，请参阅 RemoteName 成员。

此方法返回以下返回值以及其他返回值。

返回代码	说明
S_OK	成功
E_INVALIDARG	新的远程名称是无效的 URL，或者新 URL 太长 (URL 不能超过 2，200 个字符) 。

通常，如果要更改用于传输文件的 URL，或者要更改文件名或路径，则调用此方法。

此方法在返回时不序列化。若要序列化更改， 请挂起 作业，如果更改作业中的多个文件， (调用此方法，请使用循环) ，然后恢复作业。调用 IBackgroundCopyJob：：Resume 方法将序列化更改。

如果新远程名称的时间戳或文件大小与以前的远程名称不同，或者新服务器不支持 HTTP 远程名称) 的检查点恢复 (，则传递优化将重启下载。否则，传输将从新服务器上的相同位置恢复。传递优化不会重启已传输的文件。

要求	值
最低受支持的客户端	Windows 10版本 1709 [仅限桌面应用]
最低受支持的服务器	Windows Server 版本 1709 [仅限桌面应用]
标头	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
库	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyFile2定义为 83e81b93-0873-474d-8a8c-f2018b1a939c