Interface IPropertyStorage (propidlbase.h)

Artigo
08/25/2023

A interface IPropertyStorage gerencia as propriedades persistentes de um único conjunto de propriedades. As propriedades persistentes consistem em informações que podem ser armazenadas persistentemente em um conjunto de propriedades, como as informações de resumo associadas a um arquivo. Isso contrasta com as propriedades de tempo de execução associadas a Controles e Automação, que podem ser usadas para afetar o comportamento do sistema. Use os métodos da interface IPropertySetStorage para criar ou abrir um conjunto de propriedades persistentes. Uma instância da interface IPropertySetStorage pode gerenciar zero ou mais instâncias IPropertyStorage .

Cada propriedade dentro de um conjunto de propriedades é identificada por um identificador de propriedade (ID), um valor ULONG de quatro bytes exclusivo para esse conjunto. Você também pode atribuir um nome de cadeia de caracteres a uma propriedade por meio da interface IPropertyStorage .

As IDs de propriedade diferem das IDs de expedição usadas nas marcas de nome da propriedade dispid da Automação. Uma diferença é que o uso de uso geral dos valores de ID de propriedade zero e um é proibido em IPropertyStorage, enquanto essa restrição não existe no IDispatch. Além disso, embora haja uma sobreposição significativa entre os tipos de dados para valores de propriedade que podem ser usados em IPropertyStorage e IDispatch, os conjuntos de propriedades não são idênticos. Os tipos de dados de propriedade persistente usados nos métodos IPropertyStorage são definidos na estrutura PROPVARIANT .

A interface IPropertyStorage pode ser usada para acessar conjuntos de propriedades simples e não simples. Conjuntos de propriedades não simples podem conter vários tipos de propriedade complexos que não podem ser mantidos em um conjunto de propriedades simples. Para obter mais informações, consulte Armazenamento e objetos Stream para um conjunto de propriedades.

Herança

A interface IPropertyStorage herda da interface IUnknown . IPropertyStorage também tem estes tipos de membros:

Métodos

A interface IPropertyStorage tem esses métodos.


IPropertyStorage::Commit O método IPropertyStorage::Commit salva as alterações feitas em um objeto de armazenamento de propriedades no objeto de armazenamento pai.
IPropertyStorage::D eleteMultiple O método IPropertyStorage::D eleteMultiple exclui quantas propriedades indicadas existirem em um conjunto de propriedades.
IPropertyStorage::D eletePropertyNames O método IPropertyStorage::D eletePropertyNames exclui nomes de cadeia de caracteres especificados do conjunto de propriedades atual.
IPropertyStorage::Enum O método IPropertyStorage::Enum cria um objeto enumerador projetado para enumerar dados do tipo STATPROPSTG, que contém informações sobre o conjunto de propriedades atual.
IPropertyStorage::ReadMultiple O método IPropertyStorage::ReadMultiple lê as propriedades especificadas do conjunto de propriedades atual.
IPropertyStorage::ReadPropertyNames O método IPropertyStorage::ReadPropertyNames recupera todos os nomes de cadeia de caracteres existentes para as IDs de propriedade especificadas.
IPropertyStorage::Revert O método IPropertyStorage::Revert descarta todas as alterações no conjunto de propriedades nomeadas desde que foi aberto pela última vez ou descarta as alterações que foram confirmadas pela última vez no conjunto de propriedades.
IPropertyStorage::SetClass O método IPropertyStorage::SetClass atribui um novo CLSID ao objeto de armazenamento de propriedades atual e armazena persistentemente o CLSID com o objeto .
IPropertyStorage::SetTimes O método IPropertyStorage::SetTimes define os tempos de modificação, acesso e criação desse conjunto de propriedades, se houver suporte da implementação.
IPropertyStorage::Stat O método IPropertyStorage::Stat recupera informações sobre o conjunto de propriedades aberto atual. (IPropertyStorage.Stat)
IPropertyStorage::WriteMultiple O método IPropertyStorage::WriteMultiple grava um grupo de propriedades especificado no conjunto de propriedades atual.
IPropertyStorage::WritePropertyNames O método IPropertyStorage::WritePropertyNames atribui nomes de cadeia de caracteres IPropertyStorage a uma matriz especificada de IDs de propriedade no conjunto de propriedades atual.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	propidlbase.h (inclua Objbase.h, Propidlbase.h)