Структура STGOPTIONS (coml2api.h)

  • Статья

Структура STGOPTIONS определяет признаки объекта хранилища, такие как размер сектора, в функциях StgCreateStorageEx и StgOpenStorageEx .

Синтаксис

typedef struct tagSTGOPTIONS {
  USHORT      usVersion;
  USHORT      reserved;
  ULONG       ulSectorSize;
  const WCHAR *pwcsTemplateFile;
} STGOPTIONS;

Члены

usVersion

Указывает версию структуры STGOPTIONS . Для него задано значение STGOPTIONS_VERSION.

Примечание Если для usVersion задано значение 1, можно задать элемент ulSectorSize . Это полезно при создании файла документации по большому сектору. Однако если для usVersion задано значение 1, нельзя использовать элемент pwcsTemplateFile .
 
В Windows 2000 и более поздних версиях: STGOPTIONS_VERSION можно задать значение 1 для версии 1.

В Windows XP и более поздних версиях : STGOPTIONS_VERSION можно установить в значение 2 для версии 2.

Для операционных систем, предшествующих Windows 2000, STGOPTIONS_VERSION будет иметь значение 0 для версии 0.

reserved

Зарезервировано для будущего использования; должно иметь значение нуль.

ulSectorSize

Задает размер сектора объекта хранилища. Значение по умолчанию — 512 байт.

pwcsTemplateFile

Указывает имя файла, метаданные которого будут передаваться в только что созданный файл структурированного хранилища. Этот элемент действителен, только если STGFMT_DOCFILE используется с StgCreateStorageEx.

В Windows XP и более поздних версиях: Элемент pwcsTemplateFile действителен, только если в элементе usVersion указана версия 2 или более поздняя.

Комментарии

STGOPTIONS поддерживается только в API-интерфейсах Юникода.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Верхняя часть coml2api.h (включая Objbase.h)

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

Ограничения реализации составных файлов

StgCreateStorageEx

StgOpenStorageEx