Formato set di proprietà serializzate di archiviazione strutturata

I set di proprietà permanenti offrono un'opzione per archiviare i dati all'interno delle entità del file system. È consigliabile creare e gestirli usando le interfacceIPropertySetStoragee interfacce IPropertyStorage descritte in Proprietà e set di proprietà.

I set di proprietà sono costituiti da una sezione con tag di valori, con la sezione identificata in modo univoco da un identificatore di formato (FMTID). Ogni proprietà è costituita da un identificatore di proprietà e da un indicatore di tipo che rappresenta un valore. Ogni valore archiviato in un set di proprietà ha un identificatore di proprietà univoco che distingue la proprietà. L'indicatore di tipo descrive la rappresentazione dei dati nel valore .

Quando si utilizza la IPropertySetStorage e le interfacce IPropertyStorage, non è necessario gestire la struttura del formato del set di proprietà serializzato COM. Per altre informazioni, vedere gli argomenti elencati:

Tutti gli elementi di dati all'interno di un set di proprietà vengono archiviati nella rappresentazione Intel, ovvero in ordine di byte little-endian.

COM definisce un formato di dati standard e serializzato per i set di proprietà. Quando si gestisce il formato serializzato e non con le interfacce, i set di proprietà presentano le caratteristiche seguenti:

• I set di proprietà consentono a applicazioni diverse di creare set di proprietà indipendenti per gestire l'applicazione.
• I set di proprietà possono essere archiviati in una singola istanza di IStreamo in un'istanza IStorage che contiene più flussi. I set di proprietà sono semplicemente un altro tipo di dati che può essere archiviato in molte forme diverse di un'archiviazione in memoria o su disco. Per altre informazioni e convenzioni consigliate per la creazione del nome della stringa per l'oggetto di archiviazione, vedere Convenzioni di denominazione degli oggetti di archiviazione.
• I set di proprietà consentono di includere un dizionario di nomi visualizzati che descrivono il contenuto. È consigliabile scegliere un set di convenzioni per la scelta dei nomi di proprietà. Per altre informazioni su questo dizionario facoltativo, vedere identificatori di proprietà riservate, incluso ID proprietà 0.

Il flusso del set di proprietà è suddiviso in tre parti principali:

• Intestazione
• Coppia FORMATID/offset
• Sezione contenente i valori effettivi del set di proprietà

La lunghezza complessiva del flusso del set di proprietà deve essere minore o uguale a 256.000. Le sezioni seguenti, Proprietà Set Header, Format Identifier/Offset Paire Section (inclusi Property Identifiers/Offset Pair), con argomenti di supporto, descrivono i singoli componenti che compongono il formato di dati del set di proprietà.

Nota

Le versioni precedenti di questo documento descrivono le estensioni al flusso del set di proprietà con più sezioni consentite, ma che sono state modificate per fornire una sezione nel flusso delle proprietà. L'unica eccezione è set di proprietà DocumentSummaryInformation e UserDefined.