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

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

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

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

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

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

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

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

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

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

Примечание

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