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 |
|---|---|
|
O nome do arquivo foi especificado com êxito para conter os dados de resposta. |
|
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. |
|
O usuário não tem permissão para gravar no diretório especificado no cliente. |
|
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 |