Método IBackgroundCopyJob2::GetReplyFileName (bits1_5.h)
Recupera o nome do arquivo que contém os dados de resposta do aplicativo de servidor. Chame esse método somente se o tipo de trabalho for BG_JOB_TYPE_UPLOAD_REPLY.
Sintaxe
HRESULT GetReplyFileName(
[out] LPWSTR *pReplyFileName
);
Parâmetros
[out] pReplyFileName
Cadeia de caracteres terminada em nulo que contém o caminho completo para o arquivo de resposta. Chame a função CoTaskMemFree para liberar pReplyFileName quando terminar.
Retornar valor
Esse método retorna os seguintes valores HRESULT , bem como outros.
| Código de retorno | Descrição |
|---|---|
|
O nome do arquivo que contém os dados de resposta foi recuperado com êxito. |
|
Esse método não é implementado para trabalhos do tipo BG_JOB_TYPE_DOWNLOAD ou BG_JOB_TYPE_UPLOAD. |
Comentários
Para especificar um nome de arquivo de resposta, chame o método IBackgroundCopyJob2::SetReplyFileName . Se você não especificou um nome, o método GetReplyFileName retornará o nome que o BITS gerou para você. Se você não especificou um nome e chamou esse método antes de adicionar um arquivo ao trabalho, pReplyFileName será definido como NULL.
Você deve chamar o método IBackgroundCopyJob::Complete antes de abrir e ler o arquivo de resposta; o arquivo de resposta não estará disponível para o cliente até que você chame o método Complete .
O arquivo estará vazio se o aplicativo de servidor não tiver fornecido uma resposta.
Exemplos
Para obter um exemplo que usa o método GetReplyFileName , 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 |