Метод 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 , а также другие.
| Код возврата | Описание |
|---|---|
|
Успешно задано имя файла, содержащего данные ответа. |
|
Вы не сможете изменить имя файла ответов после того, как BITS начнет передавать ответ клиенту. BITS передает ответ клиенту, если состояние BG_JOB_STATE_TRANSFERRING и член BytesTotalструктуры BG_JOB_REPLY_PROGRESS не BG_SIZE_UNKNOWN. |
|
Пользователь не имеет разрешения на запись в указанный каталог на клиенте. |
|
Имя файла ответов недопустимо или превышает 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 |