Implementasi Set Properti di COM

Meskipun potensi penggunaan set properti persisten tidak sepenuhnya diketuk, saat ini ada dua penggunaan utama:

• Menyimpan informasi ringkasan dengan objek seperti dokumen
• Mentransfer data properti antar objek

Set properti COM dirancang untuk menyimpan data yang cocok untuk representasi sebagai kumpulan nilai terperinci yang cukup besar. Himpunan data yang terlalu besar agar ini layak harus dipecah menjadi aliran, penyimpanan, dan/atau set properti terpisah. Format data kumpulan properti COM tidak dimaksudkan untuk menyediakan pengganti database dari banyak objek kecil.

COM menyediakan implementasi antarmuka set properti untuk berbagai objek, bersama dengan tiga fungsi pembantu. Bagian berikut menjelaskan beberapa karakteristik performa dari implementasi ini. Untuk informasi selengkapnya tentang antarmuka tertentu dan cara mendapatkan penunjuk ke antarmuka ini, lihat yang berikut ini di bagian referensi COM:

• Implementasi File IPropertySetStorage–Compound

  Implementasi file majemuk, yang menyediakan antarmuka IStorage dan IStream , juga menyediakan antarmuka IPropertySetStorage dan IPropertyStorage . Mengingat implementasi file majemuk dari IStorage, antarmuka IPropertySetStorage dapat diperoleh dengan memanggil IUnknown::QueryInterface.

• Implementasi Sistem File IPropertySetStorage–NTFS

  Antarmuka IPropertySetStorage dan IPropertyStorage juga dapat diperoleh untuk file NTFS yang bukan file majemuk. Oleh karena itu, dimungkinkan untuk mendapatkan antarmuka ini untuk semua file pada volume NTFS.

• Implementasi IPropertySetStorage–Stand-alone

  Ketika implementasi IPropertySetStorage dan IPropertyStorage ini dibuat, implementasi ini diberikan penunjuk ke objek yang mendukung antarmuka IStorage . Kemudian memanipulasi penyimpanan set properti dalam objek penyimpanan tersebut. Dengan demikian, dimungkinkan untuk mengakses dan memanipulasi set properti pada objek apa pun yang mendukung .

• Pertimbangan Implementasi IPropertySetStorage

  Ada beberapa masalah yang perlu dipertimbangkan dalam menyediakan implementasi antarmuka IPropertySetStorage . Silakan lihat Pertimbangan Implementasi ini di bagian Referensi COM.

Selain itu, ada empat fungsi pembantu, yang dirancang untuk membantu menangani properti yang telah dibaca dari properti yang diatur ke dalam memori (ke dalam struktur PROPVARIANT ):

• PropVariantInit
• PropVariantClear
• FreePropVariantArray
• PropVariantCopy

Bagian berikut membahas implementasi set properti di COM secara lebih rinci:

• Mengelola Set Properti
• Pertimbangan Set Properti
• Menyimpan Set Properti
• Karakteristik Performa
• Menerapkan Kumpulan Properti Informasi Ringkasan
• Pertimbangan Implementasi IPropertySetStorage