Метод IBackgroundCopyFile2::SetRemoteName

Изменяет удаленное имя на новый URL-адрес в задании загрузки.

Синтаксис

HRESULT SetRemoteName(
  [in] LPCWSTR RemoteName
);

Параметры

RemoteName [in]

Строка, завершающаяся значением NULL, содержащая имя файла на сервере. Сведения об указании удаленного имени см. в разделе Элемент RemoteName .

Возвращаемое значение

Этот метод возвращает следующие возвращаемые значения, а также другие.

Код возврата	Описание
S_OK	Успешное завершение
E_INVALIDARG	Новое удаленное имя является недопустимым URL-адресом или слишком длинным (длина URL-адреса не может превышать 2200 символов).

Комментарии

Как правило, этот метод вызывается, если требуется изменить 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

См. также раздел

IBackgroundCopyFile2