Implementasi IPropertySetStorage-Stand-Alone
Implementasi IPropertySetStorage yang disediakan sistem mencakup implementasi IPropertyStorage dan IPropertySetStorage.IPropertyStorage adalah antarmuka yang membaca dan menulis properti dalam penyimpanan kumpulan properti. IPropertySetStorage adalah antarmuka yang membuat dan membuka kumpulan properti dalam penyimpanan. Antarmuka IEnumSTATPROPSTG dan IEnumSTATPROPSETST G juga disediakan dalam implementasi yang berdiri sendiri.
Untuk menggunakan implementasi mandiri IPropertySetStorage, pertama-tama dapatkan penunjuk ke implementasi yang disediakan sistem dan berdiri sendiri dan kaitkan implementasi yang disediakan sistem dengan objek penyimpanan Anda. Untuk mendapatkan penunjuk ke implementasi mandiri IPropertySetStorage, panggil fungsiStgCreatePropSetStg dan berikan parameter pStorage yang menentukan objek penyimpanan yang akan berisi kumpulan properti. Fungsi ini menyediakan penunjuk ke antarmuka IPropertySetStorage baru untuk objek penyimpanan yang ditentukan.
Implementasi mandiri IPropertySetStorage membuat kumpulan properti pada objek penyimpanan apa pun, bukan hanya pada penyimpanan file majemuk. Implementasi yang berdiri sendiri tidak bergantung pada file campuran dan dapat digunakan dengan implementasi penyimpanan terstruktur apa pun. Pembatasan apa pun pada penyimpanan terstruktur yang disediakan pemanggil berlaku untuk implementasi set properti ini. Misalnya, jika Anda menyediakan penyimpanan mode sederhana untuk StgOpenPropStg, yang dihasilkan IPropertySetStorage akan dibatasi oleh IStorage yang disediakan.
Untuk informasi selengkapnya tentang implementasi file gabungan antarmuka ini, lihat bagian IPropertySetStorage-Compound Implementasi File.
Kapan Harus Digunakan
Panggil metode IPropertySetStorage untuk membuat, membuka, dan menghapus kumpulan properti di penyimpanan terstruktur apa pun. Ada juga metode yang memasok pointer ke IEnumSTATPROPSETSTG enumerator yang dapat digunakan untuk menghitung set properti dalam penyimpanan.
Implementasi mandiri juga menyediakan fungsi pembantu StgCreatePropStg dan StgOpenPropStg, selain metode Create dan Open, untuk membuat dan membuka set properti. Kedua fungsi ini menambahkan dukungan untuk nilai PROPSETFLAG_UNBUFFERED sehingga Anda dapat menulis perubahan langsung ke kumpulan properti alih-alih menyangganya dalam cache. Untuk informasi selengkapnya, lihat PROPSETFLAG Constants.
Metode
Implementasi mandiri IPropertySetStorage mendukung metode berikut.
-
Membuat properti baru yang diatur dalam penyimpanan dan mengembalikan penunjuk ke antarmuka IPropertyStorage pada kumpulan properti.
Jika Anda berencana untuk menggunakan nilai PROPSETFLAG_UNBUFFERED, gunakan fungsiStgCreatePropStg sebagai gantinya untuk membuat dan membuka kumpulan properti baru dan untuk mendapatkan penunjuk ke implementasi mandiri untuk antarmuka IPropertyStorage pada kumpulan properti.
-
Membuka properti yang ada yang diatur dalam penyimpanan dan mengembalikan penunjuk ke antarmukaIPropertyStorage pada kumpulan properti.
Jika Anda berencana untuk menggunakan nilai PROPSETFLAG_UNBUFFERED, gunakan fungsiStgOpenPropStgsebagai gantinya untuk mendapatkan penunjuk ke implementasi mandiri IPropertyStorage pada kumpulan properti yang ditentukan.
-
Menghapus properti yang diatur dalam penyimpanan kumpulan properti ini.
-
Membuat objek yang dapat digunakan untuk menghitung strukturSTATPROPSETSTG. Setiap struktur STATPROPSETSTG menyediakan data tentang satu set properti.
Nota
Kumpulan properti DocumentSummaryInformation dan UserDefined unik karena mungkin memiliki dua bagian kumpulan properti dalam satu aliran yang mendasarinya. Untuk informasi selengkapnya, lihat Kumpulan Properti DocumentSummaryInformation dan UserDefined .
Topik terkait