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.

Código de retorno	Descrição
S_OK	O nome do arquivo foi especificado com êxito para conter os dados de resposta.
BG_E_INVALID_STATE	Não é possível alterar o nome do arquivo de resposta depois que o BITS começar a transferir a resposta para o cliente. O BITS está transferindo a resposta para o cliente se o estado for BG_JOB_STATE_TRANSFERRING e o membro BytesTotal da estrutura BG_JOB_REPLY_PROGRESS não for BG_SIZE_UNKNOWN.
E_ACCESSDENIED	O usuário não tem permissão para gravar no diretório especificado no cliente.
E_INVALIDARG	O nome do arquivo de resposta é inválido ou excede MAX_PATH.

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

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

IBackgroundCopyJob::GetReplyData

IBackgroundCopyJob::GetReplyFileName