Format Set Properti Terserialisasi Penyimpanan Terstruktur

Set properti persisten menyediakan opsi untuk menyimpan data dalam entitas sistem file. Disarankan agar, untuk membuat dan mengelolanya, Anda menggunakan antarmuka IPropertySetStorage dan IPropertyStorage yang dijelaskan dalam Properti dan Set Properti.

Kumpulan properti terdiri dari bagian nilai yang diberi tag, dengan bagian yang diidentifikasi secara unik oleh pengidentifikasi format (FMTID). Setiap properti terdiri dari pengidentifikasi properti dan indikator jenis yang mewakili nilai. Setiap nilai yang disimpan dalam kumpulan properti memiliki pengidentifikasi properti unik yang membedakan properti. Indikator jenis menjelaskan representasi data dalam nilai .

Saat Anda menggunakan antarmuka IPropertySetStorage dan IPropertyStorage , Anda tidak perlu menangani struktur format set properti berseri COM. Untuk informasi selengkapnya, lihat topik yang tercantum:

Semua elemen data dalam kumpulan properti disimpan dalam representasi Intel (yaitu, dalam urutan byte little-endian).

COM mendefinisikan format data standar yang diserialisasikan untuk kumpulan properti. Saat menangani format yang diserialisasikan, dan bukan dengan antarmuka, set properti memiliki karakteristik berikut:

• Set properti memungkinkan aplikasi yang berbeda untuk membuat set properti independen mereka sendiri untuk melayani aplikasi.
• Set properti dapat disimpan dalam satu instans IStream atau dalam instans IStorage yang berisi beberapa aliran. Kumpulan properti hanyalah jenis data lain yang dapat disimpan dalam berbagai bentuk penyimpanan dalam memori atau di disk. Untuk informasi selengkapnya dan konvensi yang direkomendasikan untuk membuat nama string untuk objek penyimpanan, lihat Konvensi Penamaan Objek Penyimpanan.
• Set properti memungkinkan kamus nama tampilan disertakan yang menjelaskan konten. Serangkaian konvensi untuk memilih nama properti disarankan. Untuk informasi selengkapnya tentang kamus opsional ini, lihat Pengidentifikasi Properti Terpesan, termasuk ID Properti 0.

Aliran set properti dibagi menjadi tiga bagian utama:

• Header
• PASANGAN FORMATID/offset
• Bagian yang berisi nilai kumpulan properti aktual

Panjang keseluruhan aliran set properti harus kurang dari atau sama dengan 256K. Bagian berikut, Header Set Properti, Pengidentifikasi Format/Pasangan Offset, dan Bagian (termasuk Pengidentifikasi Properti/Pasangan Offset), dengan topik pendukung, jelaskan komponen individual yang menyusun format data kumpulan properti.

Catatan

Versi sebelumnya dari dokumen ini menjelaskan ekstensi ke aliran set properti dengan lebih dari satu bagian yang diizinkan, tetapi yang telah direvisi untuk menyediakan satu bagian di aliran properti. Satu pengecualian adalah DocumentSummaryInformation dan UserDefined Property Sets.