Share via

Método IBackgroundCopyJob2::SetReplyFileName (bits1_5.h)

  • Artículo

Especifica el nombre del archivo que va a contener los datos de respuesta de la aplicación de servidor. Llame a este método solo si el tipo del trabajo es BG_JOB_TYPE_UPLOAD_REPLY.

Sintaxis

HRESULT SetReplyFileName(
  [in] LPCWSTR ReplyFileName
);

Parámetros

[in] ReplyFileName

Cadena terminada en NULL que contiene la ruta de acceso completa al archivo de respuesta. BITS genera el nombre de archivo si ReplyFileNamePathSpec es NULL o una cadena vacía. 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 permisos para escribir en el directorio. 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.

Valor devuelto

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

Código devuelto Descripción
S_OK
 Se especificó correctamente el nombre del archivo que contendrá los datos de respuesta.
BG_E_INVALID_STATE
 No se puede cambiar el nombre del archivo de respuesta después de que BITS comience a transferir la respuesta al cliente. BITS transfiere la respuesta al cliente si el estado es BG_JOB_STATE_TRANSFERRING y el miembro BytesTotal de la estructura BG_JOB_REPLY_PROGRESS no está BG_SIZE_UNKNOWN.
E_ACCESSDENIED
 El usuario no tiene permiso para escribir en el directorio especificado en el cliente.
E_INVALIDARG
 El nombre del archivo de respuesta no es válido o supera MAX_PATH.

Comentarios

BITS genera el nombre de archivo si no llama al método SetReplyFileName antes de llamar al método IBackgroundCopyJob::Resume por primera vez.

Si BITS genera el nombre de archivo, el archivo de respuesta se escribe en el mismo directorio que el archivo de carga local.

Puede llamar al método SetReplyFileName en cualquier momento antes de que BITS comience a descargar la respuesta de la aplicación de servidor; se produce un error en el método si se ha iniciado la descarga.

El archivo de respuesta está disponible para el cliente después de llamar al método IBackgroundCopyJob::Complete . Para recuperar los datos de respuesta antes de llamar al método Complete , llame al método IBackgroundCopyJob2::GetReplyData .

El archivo está vacío si la aplicación de servidor no proporcionó una respuesta.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2003
Plataforma de destino Windows
Encabezado bits1_5.h (incluya Bits.h)
Library Bits.lib
Archivo DLL BitsPrx2.dll
Redistribuible BITS 1.5 en Windows XP

Consulte también

IBackgroundCopyJob::GetReplyData

IBackgroundCopyJob::GetReplyFileName