Поделиться через

Метод IFileSystemImage::p ut_StageFiles (imapi2fs.h)

  • Статья

Определяет, должны ли файлы, добавляемые в образ файловой системы, быть промежуточными перед записью.

Синтаксис

HRESULT put_StageFiles(
  [in] VARIANT_BOOL newVal
);

Параметры

[in] newVal

Задайте значение VARIANT_TRUE, чтобы принудительное размещение файлов, добавленных в образ файловой системы, в одном или нескольких файлах этапа перед записью. В противном случае задайте значение VARIANT_FALSE, если промежуточное хранение не требуется и требуется более высокая производительность.

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

S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Код возврата Описание
E_NOTIMPL
 Не реализован.

Значение: 0x80004001

Комментарии

Промежуточное хранение — это процесс, в котором на жестком диске создается образ, содержащий все файлы для записи, до начала операции записи.

Присвоение этому свойству значения VARIANT_TRUE повлияет только на файлы, которые добавляются после установки свойства: эти файлы всегда будут промежуточными. Файлы, которые не были промежуточными до указанного значения свойства VARIANT_TRUE, не будут промежуточными.

При указании VARIANT_FALSE процесс создания образа файловой системы оптимизируется двумя способами:

  • Меньше времени требуется для создания образа
  • Меньше места на локальном диске используется IMAPI
Однако во избежание проблем с недостаточной работой буфера во время записи требуется определенная минимальная пропускная способность для операций чтения в неэтапных файлах. В случае, если доступность или пропускная способность файла могут не соответствовать требованиям средства записи, IMAPI принудительно выполняет промежуточное хранение файла независимо от указанного значения свойства. Например, промежуточное хранение файлов применяется для исходных файлов со съемных запоминающих устройств, таких как USB-флэш-диск.

Требования

Требование Значение
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imapi2fs.h

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

IFileSystemImage

IFileSystemImage::get_StageFiles