Interfaccia IPropertySetStorage (propidl.h)

Articolo
03/01/2024

L'interfaccia IPropertySetStorage crea, apre, elimina ed enumera le risorse di archiviazione dei set di proprietà che supportano le istanze dell'interfaccia IPropertyStorage . L'interfaccia IPropertyStorage gestisce un singolo set di proprietà in un sottooggetto di archiviazione delle proprietà; e l'interfaccia IPropertySetStorage gestisce l'archiviazione di gruppi di tali set di proprietà. Qualsiasi entità del file system può supportare IPropertySetStorage attualmente implementato nell'oggetto file composto COM.

Le interfacce IPropertySetStorage e IPropertyStorage offrono un modo uniforme per creare e gestire set di proprietà, indipendentemente dal fatto che questi set risiedano in un oggetto di archiviazione che supporta IStorage. Quando viene chiamato tramite un oggetto che supporta IStorage (ad esempio file strutturati e composti) o IStream, i set di proprietà creati sono conformi al formato del set di proprietà COM, descritto in dettaglio in Structured Storage Serialized Property Set Format. Analogamente, le proprietà scritte con IStorage nel formato del set di proprietà COM sono visibili tramite IPropertySetStorage e IPropertyStorage.

I metodi IPropertySetStorage identificano i set di proprietà tramite un identificatore univoco globale (GUID) denominato identificatore di formato (FMTID). FmTID per un set di proprietà identifica gli identificatori di proprietà nel set di proprietà, il relativo significato e tutti i vincoli sui valori. L'FMTID di un set di proprietà deve fornire anche i mezzi per modificare tale set di proprietà. Una sola istanza di un determinato FMTID può esistere alla volta all'interno di una singola risorsa di archiviazione delle proprietà.

Ereditarietà

L'interfaccia IPropertySetStorage eredita dall'interfaccia IUnknown . IPropertySetStorage include anche questi tipi di membri:

Metodi

L'interfaccia IPropertySetStorage include questi metodi.


IPropertySetStorage::Create Crea e apre un nuovo set di proprietà nell'oggetto di archiviazione del set di proprietà.
IPropertySetStorage::D elete Il metodo Delete elimina uno dei set di proprietà contenuti nell'oggetto di archiviazione del set di proprietà.
IPropertySetStorage::Enum Il metodo Enum crea un oggetto enumeratore che contiene informazioni sui set di proprietà archiviati nell'archiviazione del set di proprietà. In caso di restituzione, questo metodo fornisce un puntatore al puntatore IEnumSTATPROPSETSTG nell'oggetto enumeratore.
IPropertySetStorage::Open Apre un set di proprietà contenuto nell'oggetto di archiviazione del set di proprietà.

Commenti

Nota Esiste un'eccezione alla precedente nel set di proprietà DocumentSummaryInformation e UserDefined. Questo set di proprietà è univoco in quanto può avere due sezioni del set di proprietà in un singolo flusso sottostante. Questo set di proprietà è descritto in Set di proprietà DocumentSummaryInformation e UserDefined. La prima sezione è il set di proprietà DocumentSummaryInformation. La seconda sezione è il set di proprietà UserDefined. Ogni sezione è identificata da un identificatore di formato univoco (FMTID). Ad esempio, FMTID_DocSummaryInformation e FMTID_UserDefined set di proprietà. Il fatto che questi due set di proprietà possano esistere in un singolo flusso influisce sul comportamento dell'interfaccia IPropertySetStorage .

Quando viene chiamato IPropertySetStorage::Create per creare il set di proprietà UserDefined, la prima sezione viene creata automaticamente. Dopo aver creato il FMTID_UserDefinedProperties, non è necessario creare FMTID_DocSummaryInformation, ma può essere aperto con una chiamata a IPropertySetStorage::Open. La creazione della prima sezione non crea automaticamente la seconda sezione e non è possibile aprire entrambe le sezioni contemporaneamente.

Chiamando IPropertySetStorage::D elete, per eliminare la prima sezione, vengono eliminate entrambe le sezioni. In altre parole, la chiamata a IPropertySetStorage::D elete con FMTID_DocSummaryInformation causa l'eliminazione di tale sezione e della sezione FMTID_UserDefinedProperties. Tuttavia, l'eliminazione della seconda sezione non comporta l'eliminazione automatica della prima sezione.

Quando si utilizza IPropertySetStorage::Enum per enumerare i set di proprietà, il set di proprietà UserDefined non viene enumerato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	propidl.h (include Objbase.h)