Antarmuka IPropertyStorage (propidl.h)

Artikel
03/01/2024

Antarmuka IPropertyStorage mengelola properti persisten dari satu set properti. Properti persisten terdiri dari informasi yang dapat disimpan secara persisten dalam kumpulan properti, seperti informasi ringkasan yang terkait dengan file. Ini berbeda dengan properti run-time yang terkait dengan Kontrol dan Otomatisasi, yang dapat digunakan untuk memengaruhi perilaku sistem. Gunakan metode antarmuka IPropertySetStorage untuk membuat atau membuka kumpulan properti persisten. Instans antarmuka IPropertySetStorage dapat mengelola nol atau lebih instans IPropertyStorage .

Setiap properti dalam kumpulan properti diidentifikasi oleh pengidentifikasi properti (ID), nilai ULONG empat byte yang unik untuk set tersebut. Anda juga dapat menetapkan nama string ke properti melalui antarmuka IPropertyStorage .

ID properti berbeda dari ID pengiriman yang digunakan dalam tag nama properti dispid Automation. Salah satu perbedaannya adalah bahwa penggunaan tujuan umum nilai ID properti nol dan satu dilarang di IPropertyStorage, sementara tidak ada batasan seperti itu di IDispatch. Selain itu, meskipun ada tumpang tindih yang signifikan di antara jenis data untuk nilai properti yang dapat digunakan dalam IPropertyStorage dan IDispatch, set properti tidak identik. Jenis data properti persisten yang digunakan dalam metode IPropertyStorage ditentukan dalam struktur PROPVARIANT .

Antarmuka IPropertyStorage dapat digunakan untuk mengakses set properti sederhana dan nonsimple. Set properti nonsimple dapat menyimpan beberapa jenis properti kompleks yang tidak dapat disimpan dalam kumpulan properti sederhana. Untuk informasi selengkapnya lihat Penyimpanan dan Objek Stream untuk Kumpulan Properti.

Warisan

Antarmuka IPropertyStorage mewarisi dari antarmuka IUnknown . IPropertyStorage juga memiliki jenis anggota ini:

Metode

Antarmuka IPropertyStorage memiliki metode ini.


IPropertyStorage::Commit Metode IPropertyStorage::Commit menyimpan perubahan yang dilakukan pada objek penyimpanan properti ke objek penyimpanan induk.
IPropertyStorage::D eleteMultiple Metode IPropertyStorage::D eleteMultiple menghapus sebanyak mungkin properti yang ditunjukkan seperti yang ada dalam kumpulan properti ini.
IPropertyStorage::D eletePropertyNames Metode DeletePropertyNames menghapus nama string yang ditentukan dari kumpulan properti saat ini. (IPropertyStorage.DeletePropertyNames)
IPropertyStorage::Enum Metode IPropertyStorage::Enum membuat objek enumerator yang dirancang untuk menghitung data jenis STATPROPSTG, yang berisi informasi tentang kumpulan properti saat ini.
IPropertyStorage::ReadMultiple Metode IPropertyStorage::ReadMultiple membaca properti yang ditentukan dari kumpulan properti saat ini.
IPropertyStorage::ReadPropertyNames Metode IPropertyStorage::ReadPropertyNames mengambil nama string yang ada untuk ID properti yang ditentukan.
IPropertyStorage::Revert Metode IPropertyStorage::Revert membuang semua perubahan pada kumpulan properti bernama sejak terakhir kali dibuka atau membuang perubahan yang terakhir dilakukan pada kumpulan properti.
IPropertyStorage::SetClass Metode IPropertyStorage::SetClass menetapkan CLSID baru ke objek penyimpanan properti saat ini, dan terus menyimpan CLSID dengan objek .
IPropertyStorage::SetTimes Metode IPropertyStorage::SetTimes menetapkan waktu modifikasi, akses, dan pembuatan dari kumpulan properti ini, jika didukung oleh implementasi.
IPropertyStorage::Stat Metode IPropertyStorage::Stat mengambil informasi tentang kumpulan properti terbuka saat ini. (IPropertyStorage.Stat)
IPropertyStorage::WriteMultiple Metode IPropertyStorage::WriteMultiple menulis grup properti tertentu ke kumpulan properti saat ini.
IPropertyStorage::WritePropertyNames Metode IPropertyStorage::WritePropertyNames menetapkan string IPropertyStoragenames ke array ID properti tertentu dalam kumpulan properti saat ini.

Persyaratan

Persyaratan	Nilai
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, Propidlbase.h)