BG_FILE_INFO estructura (bits.h)

Artículo
02/26/2024

Proporciona los nombres locales y remotos del archivo que se van a transferir.

Sintaxis

typedef struct _BG_FILE_INFO {
  LPWSTR RemoteName;
  LPWSTR LocalName;
} BG_FILE_INFO;

Miembros

RemoteName

Cadena terminada en NULL que contiene el nombre del archivo en el servidor (por ejemplo, http://< server>/<path>/file.ext). El formato del nombre debe ajustarse al protocolo de transferencia que use. No se pueden usar caracteres comodín en la ruta de acceso o el nombre de archivo. La dirección URL solo debe contener caracteres de dirección URL legales; no se realiza ningún procesamiento de escape. La dirección URL está limitada a 2200 caracteres, no incluido el terminador NULL.

Cada segmento de la dirección URL está limitado a MAX_PATH caracteres.

Puede usar SMB para expresar el nombre remoto del archivo para descargar o cargar; no hay compatibilidad con SMB para trabajos de carga y respuesta. Puede especificar el nombre remoto como ruta de acceso UNC, ruta de acceso completa con una unidad de red o usar el prefijo "file://". BITS 1.5 y versiones anteriores: No se admite el protocolo SMB para RemoteName .

LocalName

Cadena terminada en NULL que contiene el nombre del archivo en el cliente. El nombre de archivo debe incluir la ruta de acceso completa (por ejemplo, d:\myapp\updates\file.ext). No puede usar caracteres comodín en la ruta de acceso o el nombre de archivo, y los directorios de la ruta de acceso deben existir. La ruta de acceso está limitada a MAX_PATH, no incluido el terminador null.

El usuario debe tener permiso para escribir en el directorio local para descargas y la parte de respuesta de un trabajo de carga-respuesta. BITS no admite secuencias NTFS. En lugar de usar unidades de red, que son específicas de la sesión, use rutas de acceso UNC (por ejemplo, \server\share\path\file). No incluya \? prefijo en la ruta de acceso.

Comentarios

BITS admite los protocolos HTTP, HTTPS y SMB para RemoteName. Para conocer los requisitos HTTP, consulte Requisitos HTTP para descargas de BITS.

BITS 1.5 y versiones anteriores: No se admite el protocolo SMB para RemoteName .

A continuación se identifica si BITS propaga las marcas de tiempo de un archivo:

En el caso de las descargas HTTP, BITS propaga la marca de tiempo de modificación del archivo y establece la hora de creación del archivo en la hora de modificación.
En el caso de las cargas HTTP, BITS no propaga las marcas de tiempo del archivo.
En el caso de las descargas y cargas de SMB, BITS propaga las marcas de tiempo del archivo.

BITS no admite rutas de acceso SMB a canalizaciones o dispositivos con nombre. Para mantener la información del propietario y la ACL de los archivos descargados mediante SMB, llame al método IBackgroundCopyJob3::SetFileACLFlags .

Si la parte de ruta de acceso y nombre de archivo de la dirección URL de un trabajo de carga y carga-respuesta HTTP contiene caracteres Unicode no comunes a la página de códigos en el cliente y el servidor, se producirá un error en la traducción de direcciones URL en el servidor y el trabajo de BITS se colocará en el estado de error. Si la parte del servidor de la dirección URL contiene caracteres Unicode, debe codificar la parte del servidor mediante nombres de dominio internacionalizados (IDN).

BITS no limita el tamaño del archivo que puede descargar mediante HTTP. Para conocer los límites de carga, consulte la propiedad de extensión BITSMaximumUploadSize IIS.

IIS 5.0: Las descargas están limitadas a 4 GB.

BITS 1.2 y versiones anteriores: En el caso de las descargas HTTP, el tamaño máximo de archivo que puede transferir es de 4 GB; BITS no puede garantizar la transferencia correcta de archivos de más de 4 GB. Si la dirección URL contiene caracteres Unicode que no están en el juego de caracteres US-ASCII, codifique la cadena Unicode en UTF-8 antes de pasarla como nombre de archivo remoto a BITS. Si no codifica la cadena, el servidor HTTP puede recibir una dirección URL incorrecta y el trabajo puede escribir el estado de error.