Formato do conjunto de propriedades serializados de armazenamento estruturado

Conjuntos de propriedades persistentes fornecem uma opção para armazenar dados dentro de entidades do sistema de arquivos. É recomendável que, para criá-los e gerenciá-los, use as interfaces IPropertySetStorage e IPropertyStorage descritas em Propriedades e Conjuntos de Propriedades.

Os conjuntos de propriedades são compostos por uma seção marcada de valores, com a seção identificada exclusivamente por um FMTID (identificador de formato). 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 .

Ao usar as interfaces IPropertySetStorage e IPropertyStorage , você não precisa lidar com a estrutura de formato do conjunto de propriedades serializada COM. Para obter mais informações, consulte os tópicos listados:

Todos os elementos de dados em 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 lidar com 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 atender ao aplicativo.
• Os conjuntos de propriedades podem ser armazenados em uma única instância 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 pode ser armazenado em várias formas diferentes de um 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 Convenções de nomenclatura de objeto de armazenamento.
• Os conjuntos de propriedades permitem que um dicionário de nomes de exibição seja incluído que descreva o conteúdo. É recomendável um conjunto de convenções para escolher nomes de propriedade. Para obter mais informações sobre esse dicionário opcional, consulte Identificadores de propriedade reservada, incluindo a ID da 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 geral 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 Deslocamento e 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.

Observação

Versões anteriores deste documento descreveram extensões para o fluxo do conjunto de propriedades com mais de uma seção permitida, mas que foi revisada para fornecer uma seção no fluxo de propriedades. A única exceção é Os conjuntos de propriedades DocumentSummaryInformation e UserDefined.