Antarmuka IPropertySetStorage (propidl.h)

Artikel
03/15/2023

Antarmuka IPropertySetStorage membuat, membuka, menghapus, dan menghitung penyimpanan set properti yang mendukung instans antarmuka IPropertyStorage . Antarmuka IPropertyStorage mengelola satu properti yang diatur dalam subobject penyimpanan properti; dan antarmuka IPropertySetStorage mengelola penyimpanan grup set properti tersebut. Entitas sistem file apa pun dapat mendukung IPropertySetStorage yang saat ini diimplementasikan dalam objek file majemuk COM.

Antarmuka IPropertySetStorage dan IPropertyStorage menyediakan cara yang seragam untuk membuat dan mengelola set properti, baik set ini berada di objek penyimpanan yang mendukung IStorage atau tidak. Ketika dipanggil melalui objek yang mendukung IStorage (seperti file terstruktur dan majemuk) atau IStream, kumpulan properti yang dibuat sesuai dengan format kumpulan properti COM, dijelaskan secara rinci dalam Format Kumpulan Properti Serial Penyimpanan Terstruktur. Demikian pula, properti yang ditulis menggunakan IStorage ke format set properti COM terlihat melalui IPropertySetStorage dan IPropertyStorage.

Metode IPropertySetStorage mengidentifikasi kumpulan properti melalui pengidentifikasi unik global (GUID) yang disebut pengidentifikasi format (FMTID). FMTID untuk kumpulan properti mengidentifikasi pengidentifikasi properti dalam kumpulan properti, maknanya, dan batasan apa pun pada nilai. FMTID dari set properti juga harus menyediakan sarana untuk memanipulasi kumpulan properti tersebut. Hanya satu instans FMTID tertentu yang mungkin ada pada satu waktu dalam satu penyimpanan properti.

Warisan

Antarmuka IPropertySetStorage mewarisi dari antarmuka IUnknown . IPropertySetStorage juga memiliki jenis anggota berikut:

Metode

Antarmuka IPropertySetStorage memiliki metode ini.


IPropertySetStorage::Create Membuat dan membuka properti baru yang diatur dalam objek penyimpanan set properti.
IPropertySetStorage::D elete Metode Hapus menghapus salah satu set properti yang terkandung dalam objek penyimpanan kumpulan properti.
IPropertySetStorage::Enum Metode Enum membuat objek enumerator yang berisi informasi tentang kumpulan properti yang disimpan dalam penyimpanan set properti ini. Saat dikembalikan, metode ini memasok pointer ke penunjuk IEnumSTATPROPSETSTG pada objek enumerator.
IPropertySetStorage::Open Membuka kumpulan properti yang terkandung dalam objek penyimpanan set properti.

Keterangan

Catatan Ada pengecualian untuk hal di atas dalam kumpulan properti DocumentSummaryInformation dan UserDefined. Kumpulan properti ini unik karena mungkin memiliki dua bagian set properti dalam satu aliran yang mendasar. Kumpulan properti ini dijelaskan dalam Kumpulan Properti DocumentSummaryInformation dan UserDefined. Bagian pertama adalah kumpulan properti DocumentSummaryInformation. Bagian kedua adalah kumpulan properti UserDefined. Setiap bagian diidentifikasi oleh pengidentifikasi format unik (FMTID). Misalnya, kumpulan properti FMTID_DocSummaryInformation dan FMTID_UserDefined. Fakta bahwa kedua set properti ini dapat ada dalam satu aliran memengaruhi perilaku antarmuka IPropertySetStorage .

Ketika IPropertySetStorage::Create dipanggil untuk membuat kumpulan properti UserDefined, bagian pertama dibuat secara otomatis. Setelah FMTID_UserDefinedProperties dibuat, FMTID_DocSummaryInformation tidak perlu dibuat, tetapi dapat dibuka dengan panggilan ke IPropertySetStorage::Open. Membuat bagian pertama tidak secara otomatis membuat bagian kedua dan tidak dimungkinkan untuk membuka kedua bagian secara bersamaan.

Memanggil IPropertySetStorage::D elete, untuk menghapus bagian pertama, menyebabkan kedua bagian dihapus. Dengan kata lain, memanggil IPropertySetStorage::D elete dengan FMTID_DocSummaryInformation menyebabkan bagian tersebut dan bagian FMTID_UserDefinedProperties dihapus. Namun, menghapus bagian kedua tidak secara otomatis menghapus bagian pertama.

Ketika IPropertySetStorage::Enum digunakan untuk menghitung set properti, kumpulan properti UserDefined tidak dijumlahkan.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	propidl.h (termasuk Objbase.h)