Метод IBackgroundCopyJob2::GetReplyFileName (bits1_5.h)
Извлекает имя файла, содержащего данные ответа, из серверного приложения. Вызывайте этот метод, только если тип задания — BG_JOB_TYPE_UPLOAD_REPLY.
Синтаксис
HRESULT GetReplyFileName(
[out] LPWSTR *pReplyFileName
);
Параметры
[out] pReplyFileName
Строка, завершающаяся значением NULL, которая содержит полный путь к файлу ответа. По завершении вызовите функцию CoTaskMemFree , чтобы освободить pReplyFileName .
Возвращаемое значение
Этот метод возвращает следующие значения HRESULT , а также другие.
| Код возврата | Описание |
|---|---|
|
Успешно получено имя файла, содержащего данные ответа. |
|
Этот метод не реализован для заданий типа 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 |