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

  • Artigo

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.

Retornar valor

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

Código de retorno Descrição
S_OK
 Os dados de resposta foram recuperados com êxito.
BG_E_TOO_LARGE
 Os dados de resposta excedem o tamanho máximo do buffer de 1 MB. O parâmetro ppBuffer é definido como NULL e pSize contém o tamanho dos dados de resposta.
BG_E_INVALID_STATE
 Para recuperar os dados de resposta, o estado do trabalho deve ser BG_JOB_STATE_TRANSFERRED.
E_NOTIMPL
 Esse método não é implementado para trabalhos do tipo BG_JOB_TYPE_DOWNLOAD ou BG_JOB_TYPE_UPLOAD.

Comentários

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 estará 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2003
Plataforma de Destino Windows
Cabeçalho bits1_5.h (inclua Bits.h)
Biblioteca Bits.lib
DLL BitsPrx2.dll
Redistribuível BITS 1.5 no Windows XP

Confira também

IBackgroundCopyJob2::GetReplyFileName

IBackgroundCopyJob2::SetReplyFileName