Compartir a través de

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

  • Artículo

Recupera una copia en memoria de 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 y su estado es BG_JOB_STATE_TRANSFERRED.

Sintaxis

HRESULT GetReplyData(
  [in, out] byte   **ppBuffer,
  [out]     UINT64 *pLength
);

Parámetros

[in, out] ppBuffer

Búfer que contiene los datos de respuesta. El método establece ppBuffer en NULL si la aplicación de servidor no devolvió una respuesta. Llame a la función CoTaskMemFree para liberar ppBuffer cuando haya terminado.

[out] pLength

Tamaño, en bytes, de los datos de respuesta en ppBuffer.

Valor devuelto

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

Código devuelto Descripción
S_OK
 Recuperó correctamente los datos de respuesta.
BG_E_TOO_LARGE
 Los datos de respuesta superan el tamaño máximo de búfer de 1 MB. El parámetro ppBuffer se establece en NULL y pSize contiene el tamaño de los datos de respuesta.
BG_E_INVALID_STATE
 Para recuperar los datos de respuesta, el estado del trabajo debe ser BG_JOB_STATE_TRANSFERRED.
E_NOTIMPL
 Este método no se implementa para trabajos de tipo BG_JOB_TYPE_DOWNLOAD o BG_JOB_TYPE_UPLOAD.

Comentarios

El método GetReplyData permite leer los datos de respuesta antes o después de llamar al método IBackgroundCopyJob::Complete . Sin embargo, para leer los datos de respuesta del archivo de respuesta, primero debe llamar al método Complete ; el archivo no está disponible para el cliente hasta que se llama al método Complete .

El método GetReplyData devuelve BG_E_TOO_LARGE si los datos de respuesta superan los 1 MB (pSize contiene el tamaño de los datos de respuesta). Para recuperar la respuesta si supera los 1 MB, llame al método IBackgroundCopyJob2::GetReplyFileName para recuperar el nombre de archivo. A continuación, abra el archivo y lea directamente los datos de respuesta.

Ejemplos

Para obtener un ejemplo que usa el método GetReplyData , vea Recuperar la respuesta de un trabajo de Upload-Reply.

Requisitos

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

Consulte también

IBackgroundCopyJob2::GetReplyFileName

IBackgroundCopyJob2::SetReplyFileName