Implementazione autonoma di IPropertySetStorage-Stand-alone
L'implementazione autonoma fornita dal sistema di IPropertySetStorage include un'implementazione di IPropertyStorage e IPropertySetStorage.IPropertyStorage è l'interfaccia che legge e scrive le proprietà in un archivio set di proprietà. IPropertySetStorage è l'interfaccia che crea e apre i set di proprietà in un archivio. Le interfacce IEnumSTATPROPSTG e IEnumSTATPROPSETSTG vengono fornite anche nell'implementazione autonoma.
Per usare l'implementazione autonoma di IPropertySetStorage, ottenere prima un puntatore all'implementazione autonoma fornita dal 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 fornire 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à in qualsiasi oggetto di archiviazione, non solo in archivi di file composti. L'implementazione autonoma non dipende da file composti e può essere usata con qualsiasi implementazione di archivi strutturati. 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 una risorsa di archiviazione in modalità semplice per StgOpenPropStg, il risultante IPropertySetStorage sarà limitato dal IStorage fornito.
Per altre informazioni sull'implementazione di file composti di questa interfaccia, vedere la sezione IPropertySetStorage-Compound Implementazione file.
Quando usare
Chiamare i metodi di IPropertySetStorage per creare, aprire ed eliminare set di proprietà in qualsiasi risorsa di archiviazione strutturata. Esiste anche un metodo che fornisce un puntatore al enumeratore IEnumSTATPROPSETSTG che può essere usato per enumerare i set di proprietà nella risorsa di archiviazione.
L'implementazione autonoma fornisce anche le funzioni helper StgCreatePropSt g e StgOpenPropStg, oltre ai metodi Create e Open, per creare e aprire set di proprietà. Queste due funzioni aggiungono il supporto per il valore PROPSETFLAG_UNBUFFERED in modo da poter scrivere le modifiche direttamente nel set di proprietà anziché memorizzarle nel buffer in una cache. Per altre informazioni, vedere costanti PROPSETFLAG.
Metodi
L'implementazione autonoma di IPropertySetStorage supporta i metodi seguenti.
-
Crea un nuovo set di proprietà nell'archiviazione e restituisce un puntatore all'interfacciaIPropertyStoragenel set di proprietà.
Se si prevede di usare il valore PROPSETFLAG_UNBUFFERED, usare invece la funzione stgCreatePropStg per creare e aprire il nuovo set di proprietà e per ottenere un puntatore all'implementazione autonoma per l'interfaccia IPropertyStorage nel set di proprietà.
-
Apre un set di proprietà esistente nella risorsa di archiviazione e restituisce un puntatore all'interfacciaIPropertyStoragenel set di proprietà.
Se si prevede di usare il valore PROPSETFLAG_UNBUFFERED, usare invece 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 di proprietà.
-
Crea un oggetto che può essere utilizzato per enumerare strutture STATPROPSETSTG. Ogni struttura STATPROPSETSTG fornisce dati su un singolo set di proprietà.
Nota
Il set di proprietà DocumentSummaryInformation e UserDefined è univoco in quanto può avere due sezioni impostate di proprietà in un singolo flusso sottostante. Per altre informazioni, vedere Set di proprietà DocumentSummaryInformation e UserDefined .
Argomenti correlati
-
Costanti PROPSETFLAG