Método IBackgroundCopyFile2::SetRemoteName

  • Artículo

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