Implementazione autonoma di IPropertySetStorage-Stand-alone
L'implementazione autonoma del sistema di IPropertySetStorage include un'implementazione di IPropertyStorage e IPropertySetStorage. IPropertyStorage è l'interfaccia che legge e scrive le proprietà in un'archiviazione del set di proprietà. IPropertySetStorage è l'interfaccia che crea e apre i set di proprietà in un archivio. Le interfacce IEnumSTATPROPSTG e IEnumSTATPROPSETSTG sono disponibili anche nell'implementazione autonoma.
Per usare l'implementazione autonoma di IPropertySetStorage, ottenere prima un puntatore all'implementazione autonoma del sistema e associare l'implementazione fornita dal sistema all'oggetto di archiviazione. Per ottenere un puntatore all'implementazione autonoma di IPropertySetStorage, chiamare la funzione StgCreatePropSetStg e specificare il parametro pStorage che specifica l'oggetto di archiviazione che conterrà il set di proprietà. Questa funzione fornisce un puntatore alla nuova interfaccia IPropertySetStorage per l'oggetto di archiviazione specificato.
L'implementazione autonoma di IPropertySetStorage crea set di proprietà su qualsiasi oggetto di archiviazione, non solo su archivi file composti. L'implementazione autonoma non dipende dai file composti e può essere usata con qualsiasi implementazione di archiviazioni strutturate. Tutte le restrizioni relative alle risorse di archiviazione strutturate fornite dal chiamante si applicano a questa implementazione dei set di proprietà. Ad esempio, se si fornisce un'archiviazione in modalità semplice a StgOpenPropStg, l'IPropertySetStorage risultante sarà limitato dall'IStorage fornito.
Per altre informazioni sull'implementazione del file composto di questa interfaccia, vedere la sezione IPropertySetStorage-Compound File Implementazione.
Utilizzo
Chiamare i metodi di IPropertySetStorage per creare, aprire ed eliminare i set di proprietà in qualsiasi archiviazione strutturata. Esiste anche un metodo che fornisce un puntatore all'enumeratore IEnumSTATPROPSETSTG che può essere usato per enumerare i set di proprietà nell'archiviazione.
L'implementazione autonoma fornisce anche le funzioni helper StgCreatePropStg e StgOpenPropStg , oltre ai metodi Create and Open , per creare e aprire set di proprietà. Queste due funzioni aggiungono il supporto per il valore PROPSETFLAG_UNBUFFERED in modo da poter scrivere modifiche direttamente al set di proprietà anziché bufferarle in una cache. Per altre informazioni, vedere Costanti PROPSETFLAG.
Metodi
L'implementazione autonoma di IPropertySetStorage supporta i metodi seguenti.
-
Crea una nuova proprietà impostata nell'archiviazione e restituisce un puntatore all'interfaccia IPropertyStorage nel set di proprietà.
Se si prevede di usare il valore PROPSETFLAG_UNBUFFERED, utilizzare la funzione StgCreatePropStg per creare e aprire il nuovo set di proprietà e ottenere un puntatore all'implementazione autonoma per l'interfaccia IPropertyStorage nel set di proprietà.
-
Apre una proprietà esistente impostata nell'archiviazione e restituisce un puntatore all'interfaccia IPropertyStorage nel set di proprietà.
Se si prevede di usare il valore PROPSETFLAG_UNBUFFERED, usare la funzione StgOpenPropStg per ottenere un puntatore all'implementazione autonoma di IPropertyStorage nel set di proprietà specificato.
-
Elimina un set di proprietà in questa risorsa di archiviazione impostata.
-
Crea un oggetto che può essere usato per enumerare le strutture STATPROPSETSTG . Ogni struttura STATPROPSETSTG fornisce dati relativi a un singolo set di proprietà.
Nota
Il set di proprietà DocumentSummaryInformation e UserDefined è univoco in quanto può avere due sezioni del set di proprietà in un singolo flusso sottostante. Per altre informazioni, vedere Set di proprietà DocumentSummaryInformation e UserDefined .
Argomenti correlati