Método IBackgroundCopyJob::AddFile (bits.h)

Artículo
02/23/2024

Agrega un único archivo al trabajo.

Sintaxis

HRESULT AddFile(
  [in] LPCWSTR RemoteUrl,
  [in] LPCWSTR LocalName
);

Parámetros

[in] RemoteUrl

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 la sección Miembro RemoteName y Comentarios de la estructura BG_FILE_INFO .

[in] LocalName

Cadena terminada en NULL que contiene el nombre del archivo en el cliente. Para obtener información sobre cómo especificar el nombre local, vea la sección Miembro LocalName y Comentarios de la estructura BG_FILE_INFO .

Valor devuelto

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

Código devuelto	Descripción
S_OK	El archivo se agregó correctamente al trabajo.
BG_E_TOO_MANY_FILES	Los trabajos de carga solo pueden contener un archivo; no puede agregar otro archivo al trabajo.
BG_E_TOO_MANY_FILES_IN_JOB	El valor de directiva de grupo MaxFilesPerJob determina cuántos archivos puede contener un trabajo. Agregar el archivo al trabajo supera el límite de MaxFilesPerJob.
E_INVALIDARG	Puede recibir este error por uno de los siguientes motivos: El nombre de archivo local o remoto no es válido. El nombre de archivo remoto usa un protocolo no admitido. El nombre de archivo local se especificó mediante una ruta de acceso relativa.
E_ACCESSDENIED	El usuario no tiene permiso para escribir en el directorio especificado en el cliente.

Comentarios

Para agregar más de un archivo a la vez a un trabajo, llame al método IBackgroundCopyJob::AddFileSet . Es más eficaz llamar al método AddFileSet al agregar varios archivos a un trabajo que llamar al método AddFile en un bucle. Para obtener más información, vea Agregar archivos a un trabajo.

Para agregar un archivo a un trabajo desde el que BITS descarga intervalos de datos del archivo, llame al método IBackgroundCopyJob3::AddFileWithRanges .

Los trabajos de carga solo pueden contener un archivo. Si agrega un segundo archivo, el método devuelve BG_E_TOO_MANY_FILES.

En el caso de las descargas, BITS garantiza que la versión de un archivo (basada en el tamaño y la fecha del archivo, no en el contenido) que las transferencias sean coherentes; sin embargo, no garantiza que un conjunto de archivos sea coherente. Por ejemplo, si BITS está en medio de descargar el segundo de dos archivos del trabajo en el momento en que los archivos se actualizan en el servidor, BITS reinicia la descarga del segundo archivo; sin embargo, el primer archivo no se vuelve a descargar.

Tenga en cuenta que si posee el archivo que se está descargando del servidor, debe crear una nueva dirección URL para cada nueva versión del archivo. Si usa la misma dirección URL para las nuevas versiones del archivo, algunos servidores proxy pueden servir datos obsoletos de su memoria caché porque no comprueban con el servidor original si el archivo está obsoleto.

En el caso de las cargas, BITS genera un error si el archivo local cambia mientras se transfiere el archivo. El código de error se BG_E_FILE_CHANGED y el contexto se BG_ERROR_CONTEXT_LOCAL_FILE.

BITS transfiere los archivos dentro de un trabajo secuencialmente. Si se produce un error al transferir un archivo, el trabajo pasa a un estado de error y no se procesan más archivos dentro del trabajo hasta que se resuelve el error.

De forma predeterminada, un usuario puede agregar hasta 200 archivos a un trabajo. Este límite no se aplica a los administradores ni a las cuentas de servicio. Para cambiar el valor predeterminado, establezca las directivas de grupo MaxFilesPerJob .

Antes de Windows Vista: No hay ningún límite en el número de archivos que un usuario puede agregar a un trabajo.

Para conocer los problemas de escalabilidad, consulte Procedimientos recomendados al usar BITS.

Ejemplos

Para obtener un ejemplo que agrega un único archivo a un trabajo, vea Agregar archivos a un trabajo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP
Servidor mínimo compatible	Windows Server 2003
Plataforma de destino	Windows
Encabezado	bits.h
Library	Bits.lib
Archivo DLL	QmgrPrxy.dll