Método IBackgroundCopyJob2::SetReplyFileName (bits1_5.h)
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 |
|---|---|
|
Se especificó correctamente el nombre del archivo que contendrá los datos de respuesta. |
|
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. |
|
El usuario no tiene permiso para escribir en el directorio especificado en el cliente. |
|
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 |