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.
Retornar valor
Esse método retorna os seguintes valores HRESULT , bem como outros.
| Código de retorno | Descrição |
|---|---|
|
Os dados de resposta foram recuperados com êxito. |
|
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. |
|
Para recuperar os dados de resposta, o estado do trabalho deve ser BG_JOB_STATE_TRANSFERRED. |
|
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 |