Antarmuka IPropertyStorage (propidl.h)

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 Aliran untuk Kumpulan Properti.

Warisan

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

Metode

Antarmuka IPropertyStorage memiliki metode ini.

 
IPropertyStorage::Commit

Menyimpan perubahan yang dilakukan pada objek penyimpanan properti ke objek penyimpanan induk. (IPropertyStorage.Commit)
IPropertyStorage::D eleteMultiple

Metode DeleteMultiple menghapus properti yang ditunjukkan sebanyak yang ada di kumpulan properti ini. (IPropertyStorage.DeleteMultiple)
IPropertyStorage::D eletePropertyNames

Metode DeletePropertyNames menghapus nama string yang ditentukan dari kumpulan properti saat ini. (IPropertyStorage.DeletePropertyNames)
IPropertyStorage::Enum

Metode Enum membuat objek enumerator yang dirancang untuk menghitung data jenis STATPROPSTG, yang berisi informasi tentang kumpulan properti saat ini. Saat kembali, metode ini memasok penunjuk ke penunjuk IEnumSTATPROPSTG pada objek ini. (IPropertyStorage.Enum)
IPropertyStorage::ReadMultiple

Membaca properti yang ditentukan dari kumpulan properti saat ini. (IPropertyStorage.ReadMultiple)
IPropertyStorage::ReadPropertyNames

Mengambil nama string yang ada untuk ID properti yang ditentukan. (IPropertyStorage.ReadPropertyNames)
IPropertyStorage::Revert

Metode Kembalikan membuang semua perubahan pada kumpulan properti bernama sejak terakhir kali dibuka atau membuang perubahan yang terakhir diterapkan ke kumpulan properti. Metode ini tidak berpengaruh pada set properti mode langsung. (IPropertyStorage.Revert)
IPropertyStorage::SetClass

Metode SetClass menetapkan CLSID baru ke objek penyimpanan properti saat ini, dan terus menyimpan CLSID dengan objek . (IPropertyStorage.SetClass)
IPropertyStorage::SetTimes

Metode SetTimes mengatur waktu modifikasi, akses, dan pembuatan dari kumpulan properti ini, jika didukung oleh implementasi. Tidak semua implementasi mendukung nilai waktu ini. (IPropertyStorage.SetTimes)
IPropertyStorage::Stat

Metode Stat mengambil informasi tentang kumpulan properti terbuka saat ini. (IPropertyStorage.Stat)
IPropertyStorage::WriteMultiple

Menulis grup properti tertentu ke kumpulan properti saat ini. (IPropertyStorage.WriteMultiple)
IPropertyStorage::WritePropertyNames

Menetapkan string IPropertyStoragenames ke array ID properti tertentu dalam kumpulan properti saat ini. (IPropertyStorage.WritePropertyNames)

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

Lihat juga

IEnumSTATPROPSETSTG

IEnumSTATPROPSTG

IPropertySetStorage

Implementasi file IPropertyStorage-Compound

Implementasi Sistem File IPropertyStorage-NTFS

Implementasi IPropertyStorage-Stand-alone

Mengelola Properti

PROPVARIANT

Pertimbangan Penyimpanan Properti

STATPROPSETSTG

STATPROPSTG

Sampel