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

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

Синтаксис

HRESULT GetReplyFileName(
  [out] LPWSTR *pReplyFileName
);

Параметры

[out] pReplyFileName

Строка, завершающаяся значением NULL, которая содержит полный путь к файлу ответа. По завершении вызовите функцию CoTaskMemFree , чтобы освободить pReplyFileName .

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

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

Код возврата	Описание
S_OK	Успешно получено имя файла, содержащего данные ответа.
E_NOTIMPL	Этот метод не реализован для заданий типа BG_JOB_TYPE_DOWNLOAD или BG_JOB_TYPE_UPLOAD.

Комментарии

Чтобы указать имя файла ответов, вызовите метод IBackgroundCopyJob2::SetReplyFileName . Если имя не указано, метод GetReplyFileName возвращает имя, созданное bits. Если вы не указали имя и вызвали этот метод перед добавлением файла в задание, параметру pReplyFileName присваивается значение NULL.

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

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

Примеры

Пример использования метода GetReplyFileName см. в разделе Получение ответа из задания Upload-Reply.

Требования

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

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

IBackgroundCopyJob2::GetReplyData

IBackgroundCopyJob2::SetReplyFileName