Метод IBackgroundCopyFile3::GetTemporaryName (bits3_0.h)

  • Статья

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

Синтаксис

HRESULT GetTemporaryName(
  [out] LPWSTR *pFilename
);

Параметры

[out] pFilename

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

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

Метод возвращает следующие возвращаемые значения.

Код возврата Описание
S_OK
 Успешное завершение

Комментарии

Приложения могут использовать этот метод для получения доступа к данным до завершения задания. Откройте файл для общего доступа на запись (FILE_SHARE_WRITE). Чтобы определить, сколько байтов было передано и доступно для чтения, вызовите метод IBackgroundCopyFile::GetProgress . Обратите внимание, что при изменении метки времени URL-адреса сведения о ходе выполнения будут возвращены к нулю.

Не открывайте файл для чтения, пока BITS не начнет передачу файла; В противном случае задание перейдет в состояние временной ошибки.

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

ACL для временного файла совпадает с окончательным файлом при вызове Complete (ACL наследуется от папки).

Чтобы определить, завершена ли передача файла BITS, можно:

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header bits3_0.h (включая Bits.h)
Библиотека Bits.lib

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

IBackgroundCopyCallback2::FileTransferred

IBackgroundCopyFile3