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

Метод ILayoutStorage::LayoutScript (objidl.h)

  • Статья

Метод LayoutScript предоставляет явные указания по переупорядочению хранилищ, потоков и элементов управления в составном файле в соответствии с порядком, в котором они будут доступны во время скачивания.

Синтаксис

HRESULT LayoutScript(
  [in] StorageLayout *pStorageLayout,
  [in] DWORD         nEntries,
  [in] DWORD         glfInterleavedFlag
);

Параметры

[in] pStorageLayout

Указатель на массив структур StorageLayout .

[in] nEntries

Количество записей в массиве структур StorageLayout .

[in] glfInterleavedFlag

Зарезервировано для последующего использования.

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

Эта функция поддерживает стандартные возвращаемые значения E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG и E_FAIL, а также следующие:

Код возврата Описание
STG_E_INVALIDPOINTER Недопустимый указатель макета хранилища.
STG_E_INVALIDFLAG Недопустимое значение glfInterleavedFlag .
STG_E_PATHNOTFOUND Указано недопустимое имя нового файла документа.
STG_E_INSUFFICIENTMEMORY Недостаточно памяти для выполнения запроса.
STG_E_INVALIDPARAMETER Один из параметров является недопустимым.
STG_E_INUSE Метод BeginMonitor был вызван во время мониторинга ILayoutStorage .

Комментарии

Чтобы предоставить явные инструкции по макету, приложение вызывает ILayoutStorage::LayoutScript, передавая массив структур StorageLayout . Каждая структура определяет один блок данных хранилища или потока и указывает, где этот блок должен быть записан в массив байтов ILockBytes .

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

При определении оптимального шаблона макета данных для всего составного файла приложение вызывает ILayoutStorage::ReLayoutDocfile , чтобы реструктурировать составной файл в соответствии с порядком, в котором были доступны его секторы данных.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header objidl.h
Библиотека Uuid.lib
DLL Ole32.dll

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

ILayoutStorage::ReLayoutDocfile

ILockBytes

StorageLayout