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

Recupera uma cópia na memória dos dados de resposta do aplicativo de servidor. Chame esse método somente se o tipo do trabalho for BG_JOB_TYPE_UPLOAD_REPLY e seu estado for BG_JOB_STATE_TRANSFERRED.

Sintaxe

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

Parâmetros

[in, out] ppBuffer

Buffer para conter os dados de resposta. O método define ppBuffer como NULL se o aplicativo de servidor não retornou uma resposta. Chame a função CoTaskMemFree para liberar ppBuffer quando terminar.

[out] pLength

Tamanho, em bytes, dos dados de resposta no ppBuffer.

Valor de retorno

Esse método retorna os seguintes valores HRESULT , bem como outros.

Observações

O método GetReplyData permite que você leia os dados de resposta antes ou depois de chamar o método IBackgroundCopyJob::Complete . No entanto, para ler os dados de resposta do arquivo de resposta, você deve primeiro chamar o método Complete ; o arquivo não está disponível para o cliente até que você chame o método Complete .

O método GetReplyData retorna BG_E_TOO_LARGE se os dados de resposta excederem 1 MB (pSize contém o tamanho dos dados de resposta). Para recuperar a resposta se exceder 1 MB, chame o método IBackgroundCopyJob2::GetReplyFileName para recuperar o nome do arquivo. Em seguida, abra o arquivo e leia os dados de resposta diretamente.

Exemplos

Para obter um exemplo que usa o método GetReplyData , consulte Recuperando a resposta de um trabalho de Upload-Reply.

Requirements

Consulte também

IBackgroundCopyJob2::GetReplyFileName

IBackgroundCopyJob2::SetReplyFileName