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
S_OK	O nome do arquivo que contém os dados de resposta foi recuperado com êxito.
E_NOTIMPL	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

Confira também

IBackgroundCopyJob2::GetReplyData

IBackgroundCopyJob2::SetReplyFileName