Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 |
|---|---|
|
Recuperó correctamente los datos de respuesta. |
|
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. |
|
Para recuperar los datos de respuesta, el estado del trabajo debe ser BG_JOB_STATE_TRANSFERRED. |
|
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 |