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


Интерфейс IPropertyStorage (propidl.h)

Интерфейс IPropertyStorage управляет постоянными свойствами одного набора свойств. Постоянные свойства состоят из сведений, которые могут постоянно храниться в наборе свойств, например сводной информации, связанной с файлом. Это контрастирует со свойствами времени выполнения, связанными с элементами управления и автоматизацией, которые можно использовать для влияния на поведение системы. Используйте методы интерфейса IPropertySetStorage для создания или открытия постоянного набора свойств. Экземпляр интерфейса IPropertySetStorage может управлять нулевым или более экземплярами IPropertyStorage .

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

Идентификаторы свойств отличаются от идентификаторов диспетчеризации, используемых в тегах имен свойств dispid службы автоматизации. Одно из отличий заключается в том, что в IPropertyStorage использование значений идентификатора свойства общего назначения запрещено, в то время как в IDispatch такого ограничения не существует. Кроме того, несмотря на значительное перекрытие между типами данных для значений свойств, которые могут использоваться в IPropertyStorage и IDispatch, наборы свойств не идентичны. Типы данных постоянных свойств, используемые в методах IPropertyStorage , определяются в структуре PROPVARIANT .

Интерфейс IPropertyStorage можно использовать для доступа к простым и неимпляным наборам свойств. Наборы свойств nonsimple могут содержать несколько сложных типов свойств, которые нельзя хранить в простом наборе свойств. Дополнительные сведения см. в разделе Хранилище и Stream объекты для набора свойств.

Наследование

Интерфейс IPropertyStorage наследуется от интерфейса IUnknown . IPropertyStorage также имеет следующие типы элементов:

Методы

Интерфейс IPropertyStorage содержит следующие методы.

 
IPropertyStorage::Commit

Метод IPropertyStorage::Commit сохраняет изменения, внесенные в объект хранилища свойств, в родительский объект хранилища.
IPropertyStorage::D eleteMultiple

Метод IPropertyStorage::D eleteMultiple удаляет столько указанных свойств, сколько существует в этом наборе свойств.
IPropertyStorage::D eletePropertyNames

Метод DeletePropertyNames удаляет указанные строковые имена из текущего набора свойств. (IPropertyStorage.DeletePropertyNames)
IPropertyStorage::Enum

Метод IPropertyStorage::Enum создает объект перечислителя, предназначенный для перечисления данных типа STATPROPSTG, который содержит сведения о текущем наборе свойств.
IPropertyStorage::ReadMultiple

Метод IPropertyStorage::ReadMultiple считывает указанные свойства из текущего набора свойств.
IPropertyStorage::ReadPropertyNames

Метод IPropertyStorage::ReadPropertyNames извлекает все существующие строковые имена для указанных идентификаторов свойств.
IPropertyStorage::Revert

Метод IPropertyStorage::Revert отменяет все изменения именованного набора свойств с момента последнего открытия или отменяет изменения, которые были зафиксированы в последнее время в наборе свойств.
IPropertyStorage::SetClass

Метод IPropertyStorage::SetClass назначает новый ИДЕНТИФИКАТОР CLSID текущему объекту хранилища свойств и постоянно сохраняет CLSID вместе с объектом .
IPropertyStorage::SetTimes

Метод IPropertyStorage::SetTimes задает время изменения, доступа и создания этого набора свойств, если это поддерживается реализацией.
IPropertyStorage::Stat

Метод IPropertyStorage::Stat извлекает сведения о текущем открытом наборе свойств. (IPropertyStorage.Stat)
IPropertyStorage::WriteMultiple

Метод IPropertyStorage::WriteMultiple записывает указанную группу свойств в текущий набор свойств.
IPropertyStorage::WritePropertyNames

Метод IPropertyStorage::WritePropertyNames назначает строковые IPropertyStoragenames указанному массиву идентификаторов свойств в текущем наборе свойств.

Требования

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

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

IEnumSTATPROPSETSTG

IEnumSTATPROPSTG

IPropertySetStorage

Реализация составного файла IPropertyStorage

Реализация файловой системы IPropertyStorage-NTFS

Автономная реализация IPropertyStorage

Управление свойствами

PROPVARIANT

Рекомендации по хранилищу свойств

STATPROPSETSTG

STATPROPSTG

Примеры