Método IBackgroundCopyFile2::SetRemoteName

Cambia el nombre remoto a una nueva dirección URL en un trabajo de descarga.

Sintaxis

HRESULT SetRemoteName(
  [in] LPCWSTR RemoteName
);

Parámetros

RemoteName [in]

Cadena terminada en NULL que contiene el nombre del archivo en el servidor. Para obtener información sobre cómo especificar el nombre remoto, vea el miembro RemoteName .

Valor devuelto

Este método devuelve los siguientes valores devueltos, así como otros.

Código devuelto	Descripción
S_OK	Correcto
E_INVALIDARG	El nuevo nombre remoto es una dirección URL no válida o la nueva dirección URL es demasiado larga (la dirección URL no puede superar los 2200 caracteres).

Comentarios

Normalmente, se llama a este método si desea cambiar la dirección URL usada para transferir el archivo o si desea cambiar el nombre de archivo o la ruta de acceso.

Este método no serializa cuando devuelve. Para serializar el cambio, suspenda el trabajo, llame a este método (si cambia varios archivos en el trabajo, use un bucle) y reanude el trabajo. Al llamar al método IBackgroundCopyJob::Resume , se serializa el cambio.

Si la marca de tiempo o el tamaño de archivo del nuevo nombre remoto es diferente del nombre remoto anterior o el nuevo servidor no admite la reanudación del punto de comprobación (para nombres remotos HTTP), optimización de distribución reinicia la descarga. De lo contrario, la transferencia se reanuda desde la misma posición en el nuevo servidor. Optimización de distribución no reinicia los archivos ya transferidos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1709 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server, versión 1709 [solo aplicaciones de escritorio]
Encabezado	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Biblioteca	Dosvc.lib
Archivo DLL	Dosvc.dll
IID	IID_IBackgroundCopyFile2 se define como 83e81b93-0873-474d-8a8c-f2018b1a939c

Consulte también

IBackgroundCopyFile2