Поделиться через


Метод IBackgroundCopyJob2::SetReplyFileName (bits1_5.h)

Указывает имя файла, содержащего данные ответа из серверного приложения. Вызывайте этот метод, только если тип задания BG_JOB_TYPE_UPLOAD_REPLY.

Синтаксис

HRESULT SetReplyFileName(
  [in] LPCWSTR ReplyFileName
);

Параметры

[in] ReplyFileName

Строка, завершающаяся значением NULL, которая содержит полный путь к файлу ответа. BITS создает имя файла, если replyFileNamePathSpec имеет значение NULL или пустую строку. Нельзя использовать подстановочные знаки в пути или имени файла, и каталоги в пути должны существовать. Путь ограничен MAX_PATH, не включая признак конца null. Пользователь должен иметь разрешения на запись в каталог. BITS не поддерживает потоки NTFS. Вместо использования сетевых дисков, которые зависят от сеанса, используйте UNC-пути (например, \server\share\path\file). Не включайте \? префикс в пути.

Возвращаемое значение

Этот метод возвращает следующие значения HRESULT , а также другие.

Код возврата Описание
S_OK
Успешно задано имя файла, содержащего данные ответа.
BG_E_INVALID_STATE
Вы не сможете изменить имя файла ответов после того, как BITS начнет передавать ответ клиенту. BITS передает ответ клиенту, если состояние BG_JOB_STATE_TRANSFERRING и член BytesTotalструктуры BG_JOB_REPLY_PROGRESS не BG_SIZE_UNKNOWN.
E_ACCESSDENIED
Пользователь не имеет разрешения на запись в указанный каталог на клиенте.
E_INVALIDARG
Имя файла ответов недопустимо или превышает MAX_PATH.

Комментарии

BITS создает имя файла, если вы не вызываете метод SetReplyFileName перед первым вызовом метода IBackgroundCopyJob::Resume .

Если BITS создает имя файла, файл ответа записывается в тот же каталог, что и локальный файл отправки.

Метод SetReplyFileName можно вызвать в любое время, прежде чем BITS начнет скачивание ответа из серверного приложения. Если скачивание началось, метод завершается ошибкой.

Файл ответов доступен клиенту после вызова метода IBackgroundCopyJob::Complete . Чтобы получить данные ответа перед вызовом метода Complete , вызовите метод IBackgroundCopyJob2::GetReplyData .

Файл пуст, если серверное приложение не предоставило ответ.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2003
Целевая платформа Windows
Header bits1_5.h (включая Bits.h)
Библиотека Bits.lib
DLL BitsPrx2.dll
Распространяемые компоненты BITS 1.5 в Windows XP

См. также раздел

IBackgroundCopyJob::GetReplyData

IBackgroundCopyJob::GetReplyFileName