Compartir a través de


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

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.

Syntax

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 de retorno Description
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.

Observaciones

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 llame 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 los datos de respuesta directamente.

Examples

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

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows Vista
Servidor mínimo admitido Windows Server 2003
de la plataforma de destino de Windows
Header bits1_5.h (include Bits.h)
Library Bits.lib
DLL de BitsPrx2.dll
Redistribuible BITS 1.5 en Windows XP

Consulte también

IBackgroundCopyJob2::GetReplyFileName

IBackgroundCopyJob2::SetReplyFileName