Автономная реализация IPropertySetStorage
Предоставляемая системой автономная реализация IPropertySetStorage включает реализацию IPropertyStorage и IPropertySetStorage. IPropertyStorage — это интерфейс, который считывает и записывает свойства в хранилище наборов свойств. IPropertySetStorage — это интерфейс, который создает и открывает наборы свойств в хранилище. Интерфейсы IEnumSTATPROPSTG и IEnumSTATPROPSETSTG также предоставляются в автономной реализации.
Чтобы использовать автономную реализацию IPropertySetStorage, сначала получите указатель на предоставленную системой автономную реализацию и свяжите предоставленную системой реализацию с объектом хранилища. Чтобы получить указатель на автономную реализацию IPropertySetStorage, вызовите функцию StgCreatePropSetStg и укажите параметр pStorage , указывающий объект хранилища, который будет содержать набор свойств. Эта функция предоставляет указатель на новый интерфейс IPropertySetStorage для указанного объекта хранилища.
Автономная реализация IPropertySetStorage создает наборы свойств для любого объекта хранения, а не только в хранилищах составных файлов. Автономная реализация не зависит от составных файлов и может использоваться с любой реализацией структурированных хранилищ. Все ограничения на предоставляемые вызывающим структурированным хранилищам применяются к этой реализации наборов свойств. Например, если предоставить простое хранилище для StgOpenPropStg, результирующая функция IPropertySetStorage будет ограничена предоставленным IStorage.
Дополнительные сведения о реализации составного файла этого интерфейса см. в разделе IPropertySetStorage-Compound File Implementation.
Назначение
Вызовите методы IPropertySetStorage для создания, открытия и удаления наборов свойств в любом структурированном хранилище. Существует также метод, предоставляющий указатель на перечислитель IEnumSTATPROPSETSTG , который можно использовать для перечисления наборов свойств в хранилище.
Автономная реализация также предоставляет вспомогательные функции StgCreatePropStg и StgOpenPropStg , а также методы Create и Open для создания и открытия наборов свойств. Эти две функции добавляют поддержку значения PROPSETFLAG_UNBUFFERED, чтобы вы могли записывать изменения непосредственно в набор свойств, а не помещать их в кэш. Дополнительные сведения см. в разделе Константы PROPSETFLAG.
Методы
Автономная реализация IPropertySetStorage поддерживает следующие методы.
-
Создает новый набор свойств в хранилище и возвращает указатель на интерфейс IPropertyStorage в наборе свойств.
Если вы планируете использовать значение PROPSETFLAG_UNBUFFERED, используйте вместо этого функцию StgCreatePropStg , чтобы создать и открыть новый набор свойств и получить указатель на автономную реализацию интерфейса IPropertyStorage в наборе свойств.
-
Открывает существующий набор свойств в хранилище и возвращает указатель на интерфейс IPropertyStorage в наборе свойств.
Если вы планируете использовать значение PROPSETFLAG_UNBUFFERED, используйте вместо этого функцию StgOpenPropStg , чтобы получить указатель на автономную реализацию IPropertyStorage в указанном наборе свойств.
-
Удаляет набор свойств в хранилище этого набора свойств.
-
Создает объект , который можно использовать для перечисления структур STATPROPSETSTG . Каждая структура STATPROPSETSTG предоставляет данные об одном наборе свойств.
Примечание
Набор свойств DocumentSummaryInformation и UserDefined уникален тем, что он может содержать два раздела набора свойств в одном базовом потоке. Дополнительные сведения см. в разделах Наборы свойств DocumentSummaryInformation и UserDefined .
Связанные темы