Interfaccia IPropertySetStorage (propidl.h)
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
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) |
Vedi anche
Implementazione di file IPropertySetStorage-Compound
Implementazione del file system IPropertySetStorage-NTFS