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

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

  • Статья

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

Синтаксис

HRESULT get_StageFiles(
  [out] VARIANT_BOOL *pVal
);

Параметры

[out] pVal

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

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

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

Код возврата Описание
E_POINTER
 Недопустимый указатель.

Значение: 0x80004003

Комментарии

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

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

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

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

Требования

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

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

IFileSystemImage

IFileSystemImage::p ut_StageFiles