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

Статья
08/22/2023

Указывает имя файла, содержащего данные ответа из серверного приложения. Вызывайте этот метод, только если тип задания 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.

Метод 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

Share via