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

Формат набора сериализованных свойств структурированного хранилища

  • Статья

Наборы постоянных свойств предоставляют возможность хранения данных в сущностях файловой системы. Рекомендуется создавать и управлять ими, использовать интерфейсы IPropertySetStorage и интерфейсы IPropertyStorage, описанные в свойствах и наборах свойств.

Наборы свойств состоят из помеченного раздела значений с уникальным идентификатором формата (FMTID). Каждое свойство состоит из идентификатора свойства и индикатора типа, представляющего значение. Каждое значение, хранящееся в наборе свойств, имеет уникальный идентификатор свойства, который отличает свойство. Индикатор типа описывает представление данных в значении.

При использовании интерфейсов IPropertySetStorage и интерфейсов IPropertyStorage не требуется обрабатывать структуру набора сериализованных свойств COM. Дополнительные сведения см. в перечисленных разделах:

Все элементы данных в наборе свойств хранятся в представлении Intel (то есть в байтовом порядке).

COM определяет стандартный сериализованный формат данных для наборов свойств. При обработке сериализованного формата, а не с интерфейсами наборы свойств имеют следующие характеристики:

  • Наборы свойств позволяют различным приложениям создавать собственные независимые наборы свойств для обслуживания приложения.
  • Наборы свойств можно хранить в одном экземпляре IStream или в экземпляре IStorage IStorage, который содержит несколько потоков. Наборы свойств — это просто другой тип данных, который может храниться в различных формах хранилища в памяти или на диске. Дополнительные сведения и рекомендуемые соглашения по созданию строкового имени объекта хранилища см. в соглашения об именовании объектов хранилища.
  • Наборы свойств позволяют включить словарь отображаемых имен, описывающих содержимое. Рекомендуется использовать набор соглашений для выбора имен свойств. Дополнительные сведения об этом необязательном словаре см. в зарезервированных идентификаторов свойств, включая идентификатор свойства 0.

Поток набора свойств делится на три основные части:

  • Заголовок
  • Пара FORMATID/offset
  • Раздел, содержащий фактические значения набора свойств

Общая длина потока набора свойств должна быть меньше или равна 256K. В следующих разделах заголовка набора свойств, идентификатора и смещения и раздела (включая идентификаторы свойств и пары смещения) со вспомогательными разделами, описываются отдельные компоненты, составляющие формат данных набора свойств.

Заметка

Предыдущие версии этого документа описывают расширения для потока набора свойств с несколькими разделами, разрешенными, но были изменены, чтобы предоставить один раздел в потоке свойств. Одним из исключений является Наборы свойств DocumentSummaryInformation и UserDefined.