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