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

Especifica o nome do arquivo para conter os dados de resposta do aplicativo de servidor. Chame esse método somente se o tipo do trabalho for BG_JOB_TYPE_UPLOAD_REPLY.

Sintaxe

HRESULT SetReplyFileName(
  [in] LPCWSTR ReplyFileName
);

Parâmetros

[in] ReplyFileName

Cadeia de caracteres terminada em nulo que contém o caminho completo para o arquivo de resposta. O BITS gerará o nome do arquivo se ReplyFileNamePathSpec for NULL ou uma cadeia de caracteres vazia. Você não pode usar curingas no caminho ou no nome do arquivo e os diretórios no caminho devem existir. O caminho é limitado a MAX_PATH, não incluindo o terminador nulo. O usuário deve ter permissões para gravar no diretório. O BITS não dá suporte a fluxos NTFS. Em vez de usar unidades de rede, que são específicas da sessão, use caminhos UNC (por exemplo, \server\share\path\file). Não incluir o \? prefixo no caminho.

Retornar valor

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

Comentários

O BITS gerará o nome do arquivo se você não chamar o método SetReplyFileName antes de chamar o método IBackgroundCopyJob::Resume pela primeira vez.

Se o BITS gerar o nome do arquivo, o arquivo de resposta será gravado no mesmo diretório que o arquivo de upload local.

Você pode chamar o método SetReplyFileName a qualquer momento antes que o BITS comece a baixar a resposta do aplicativo do servidor; o método falhará se o download tiver começado.

O arquivo de resposta está disponível para o cliente depois de chamar o método IBackgroundCopyJob::Complete . Para recuperar os dados de resposta antes de chamar o método Complete , chame o método IBackgroundCopyJob2::GetReplyData .

O arquivo estará vazio se o aplicativo de servidor não tiver fornecido uma resposta.

Requisitos

Confira também

IBackgroundCopyJob::GetReplyData

IBackgroundCopyJob::GetReplyFileName