Partilhar via


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

Recupera o nome do arquivo que contém os dados de resposta do aplicativo do 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.

Valor de retorno

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

Código de retorno Description
S_OK
Recuperou com êxito o nome do arquivo que contém os dados de resposta.
E_NOTIMPL
Esse método não é implementado para trabalhos do tipo BG_JOB_TYPE_DOWNLOAD ou BG_JOB_TYPE_UPLOAD.

Observações

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 está disponível para o cliente até que você chame o método Complete .

O arquivo estará vazio se o aplicativo do 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.

Requirements

Requirement Value
Cliente mínimo suportado Windows Vista
Servidor mínimo compatível Windows Server 2003
da Plataforma de Destino Windows
Header bits1_5.h (inclua Bits.h)
Library Bits.lib
de DLL BitsPrx2.dll
Redistribuível BITS 1.5 no Windows XP

Consulte também

IBackgroundCopyJob2::GetReplyData

IBackgroundCopyJob2::SetReplyFileName