Функция StgOpenLayoutDocfile (objbase.h)

Статья
02/29/2024

Не поддерживается.

Функция StgOpenLayoutDocfile открывает составной файл в реализации ILockBytes , которая может отслеживать данные сектора. Чтобы вызвать StgOpenLayoutDocfile, требуются как DfLayout.dll, так и DfLayout.lib.

Примечание Не используйте эту функцию. Вместо этого используйте метод IStorage::CopyTo . CopyTo можно использовать для размещения файла документов, что повышает производительность в большинстве сценариев.

Синтаксис

HRESULT StgOpenLayoutDocfile(
  [in]  OLECHAR const *pwcsDfName,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved,
  [out] IStorage      **ppstgOpen
);

Параметры

[in] pwcsDfName

Указатель на строковое имя в Юникоде, завершаемого null, открываемого составного файла.

[in] grfMode

Режим доступа, используемый при открытии только что созданного объекта хранилища. Значения взяты из констант STGM. Имейте в виду, что режим приоритета и исключения не поддерживаются. Наиболее распространенный режим доступа, скорее всего, будет STGM_DIRECT | STGM_READ | STGM_SHARE_EXCLUSIVE.

[in] reserved

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

[out] ppstgOpen

Указатель на переменную указателя IStorage , которая получает указатель интерфейса на корневой объект только что созданного корневого объекта хранилища.

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

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

Функция StgOpenLayoutDocfile также может возвращать любые значения ошибок, возвращаемые функцией StgOpenStorageOnILockBytes .

Реализация составного файла, созданная этой функцией, предоставляет интерфейс ILayoutStorage в корневом хранилище. Приложения используют этот интерфейс для выражения оптимального макета составных файлов, чтобы быстрее скачивать и отображать данные по медленному каналу. StgOpenLayoutDocfile возвращает указатель на интерфейс IStorage в корневом хранилище только что созданного составного файла. Используя этот указатель, приложения вызывают QueryInterface , чтобы получить указатель на ILayoutStorage.