Formato do conjunto de propriedades serializadas do armazenamento estruturado

Os conjuntos de propriedades persistentes fornecem uma opção para armazenar dados em entidades do sistema de arquivos. É recomendável que, para criá-los e gerenciá-los, você use o IPropertySetStorage e IPropertyStorage interfaces descritas em Properties and Property Sets.

Os conjuntos de propriedades são compostos por uma seção marcada de valores, com a seção identificada exclusivamente por um identificador de formato (FMTID). Cada propriedade consiste em um identificador de propriedade e um indicador de tipo que representa um valor. Cada valor armazenado em um conjunto de propriedades tem um identificador de propriedade exclusivo que distingue a propriedade. O indicador de tipo descreve a representação dos dados no valor.

Quando você usa o IPropertySetStorage e IPropertyStorage interfaces, não é necessário manipular a estrutura de formato do conjunto de propriedades serializado COM. Para obter mais informações, consulte os tópicos listados:

Todos os elementos de dados dentro de um conjunto de propriedades são armazenados na representação Intel (ou seja, em ordem de bytes little-endian).

COM define um formato de dados serializado padrão para conjuntos de propriedades. Ao manipular o formato serializado, e não com as interfaces, os conjuntos de propriedades têm as seguintes características:

• Os conjuntos de propriedades permitem que diferentes aplicativos criem seus próprios conjuntos de propriedades independentes para servir o aplicativo.
• Os conjuntos de propriedades podem ser armazenados em uma única instância de IStream ou em uma instância IStorage que contém vários fluxos. Os conjuntos de propriedades são simplesmente outro tipo de dados que podem ser armazenados em muitas formas diferentes de armazenamento na memória ou em disco. Para obter mais informações e convenções recomendadas para criar o nome da cadeia de caracteres para o objeto de armazenamento, consulte Storage Object Naming Conventions.
• Os conjuntos de propriedades permitem a inclusão de um dicionário de nomes para exibição que descrevem o conteúdo. Recomenda-se um conjunto de convenções para escolher nomes de propriedades. Para obter mais informações sobre esse dicionário opcional, consulte Identificadores de propriedade reservados, incluindo ID de propriedade 0.

O fluxo do conjunto de propriedades é dividido em três partes principais:

• Cabeçalho
• Par FORMATID/offset
• Seção que contém os valores reais do conjunto de propriedades

O comprimento total do fluxo do conjunto de propriedades deve ser menor ou igual a 256K. As seções a seguir, Cabeçalho do Conjunto de Propriedades, Identificador de Formato/Par de Deslocamentoe Seção (incluindo Identificadores de Propriedade/Pares de Deslocamento), com tópicos de suporte, descrevem os componentes individuais que compõem o formato de dados do conjunto de propriedades.