Bagikan melalui

Implementasi IPropertySetStorage-Stand-Alone

  • Artikel

Implementasi IPropertySetStorage yang disediakan sistem dan berdiri sendiri mencakup implementasi IPropertyStorage dan IPropertySetStorage. IPropertyStorage adalah antarmuka yang membaca dan menulis properti dalam penyimpanan set properti. IPropertySetStorage adalah antarmuka yang membuat dan membuka set properti dalam penyimpanan. Antarmuka IEnumSTATPROPSTG dan IEnumSTATPROPSETSTG juga disediakan dalam implementasi yang berdiri sendiri.

Untuk menggunakan implementasi IPropertySetStorage yang berdiri sendiri, pertama-tama dapatkan pointer ke implementasi yang disediakan sistem, berdiri sendiri dan kaitkan implementasi yang disediakan sistem dengan objek penyimpanan Anda. Untuk mendapatkan penunjuk ke implementasi IPropertySetStorage yang berdiri sendiri, panggil fungsi StgCreatePropSetStg 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 IPropertySetStorage yang berdiri sendiri membuat set 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 penelepon berlaku untuk implementasi set properti ini. Misalnya, jika Anda menyediakan penyimpanan mode sederhana ke StgOpenPropStg, IPropertySetStorage yang dihasilkan akan dibatasi oleh IStorage yang disediakan.

Untuk informasi selengkapnya tentang implementasi file majemuk antarmuka ini, lihat bagian Implementasi File IPropertySetStorage-Compound.

Kapan Digunakan

Panggil metode IPropertySetStorage untuk membuat, membuka, dan menghapus kumpulan properti di penyimpanan terstruktur apa pun. Ada juga metode yang memasok pointer ke enumerator IEnumSTATPROPSETSTG yang dapat digunakan untuk menghitung set properti dalam penyimpanan.

Implementasi yang berdiri sendiri juga menyediakan fungsi pembantu StgCreatePropStg dan StgOpenPropStg , selain metode Buat dan Buka , 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 Konstanta PROPSETFLAG.

Metode

Implementasi IPropertySetStorage yang berdiri sendiri mendukung metode berikut.

IPropertySetStorage::Create

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 fungsi StgCreatePropStg sebagai gantinya untuk membuat dan membuka kumpulan properti baru dan untuk mendapatkan penunjuk ke implementasi mandiri untuk antarmuka IPropertyStorage pada kumpulan properti.

IPropertySetStorage::Open

Membuka properti yang ada yang diatur dalam penyimpanan dan mengembalikan penunjuk ke antarmuka IPropertyStorage pada set properti.

Jika Anda berencana untuk menggunakan nilai PROPSETFLAG_UNBUFFERED, gunakan fungsi StgOpenPropStg sebagai gantinya untuk mendapatkan penunjuk ke implementasi IPropertyStorage yang berdiri sendiri pada kumpulan properti yang ditentukan.

IPropertySetStorage::D elete

Menghapus properti yang diatur dalam penyimpanan set properti ini.

IPropertySetStorage::Enum

Membuat objek yang dapat digunakan untuk menghitung struktur STATPROPSETSTG . Setiap struktur STATPROPSETSTG menyediakan data tentang satu set properti.

Catatan

Kumpulan properti DocumentSummaryInformation dan UserDefined unik karena mungkin memiliki dua bagian set properti dalam satu aliran yang mendasarinya. Untuk informasi selengkapnya, lihat Kumpulan Properti DocumentSummaryInformation dan UserDefined .

 

Implementasi IPropertyStorage-Stand-Alone

IPropertySetStorage

IPropertyStorage

IStorage::Enumelements

Konstanta PROPSETFLAG

STATPROPSETSTG

StgCreatePropSetStg

StgCreatePropStg

StgOpenPropStg

Konstanta STGM