Antarmuka IStorage (objidl.h)
Antarmuka IStorage mendukung pembuatan dan pengelolaan objek penyimpanan terstruktur. Penyimpanan terstruktur memungkinkan penyimpanan informasi hierarkis dalam satu file, dan sering disebut sebagai "sistem file dalam file". Elemen objek penyimpanan terstruktur adalah penyimpanan dan aliran. Penyimpanan dianalogikan dengan direktori, dan aliran dianalogikan dengan file. Dalam penyimpanan terstruktur akan ada objek penyimpanan utama yang mungkin berisi substorase, mungkin berlapis, dan aliran. Penyimpanan menyediakan struktur objek, dan aliran berisi data, yang dimanipulasi melalui antarmuka IStream .
Antarmuka IStorage menyediakan metode untuk membuat dan mengelola objek penyimpanan akar, objek penyimpanan anak, dan objek streaming. Metode ini dapat membuat, membuka, menghitung, memindahkan, menyalin, mengganti nama, atau menghapus elemen di objek penyimpanan.
Aplikasi harus merilis pointer IStorage-nya ketika selesai dengan objek penyimpanan untuk membatalkan alokasi memori yang digunakan. Ada juga metode untuk mengubah tanggal dan waktu elemen.
Ada sejumlah mode berbeda di mana objek penyimpanan dan elemennya dapat dibuka, ditentukan dengan mengatur nilai dari Konstanta STGM. Salah satu aspek dari hal ini adalah bagaimana perubahan diterapkan. Anda dapat mengatur mode langsung, di mana perubahan pada objek segera ditulis ke dalamnya, atau mode yang ditransaksikan, di mana perubahan ditulis ke buffer hingga diterapkan secara eksplisit. Antarmuka IStorage menyediakan metode untuk melakukan perubahan dan kembali ke versi yang terakhir diterapkan. Misalnya, aliran dapat dibuka dalam mode baca-saja atau mode baca/tulis. Untuk informasi selengkapnya, lihat Konstanta STGM.
Metode lain menyediakan akses ke informasi tentang objek penyimpanan dan elemennya melalui struktur STATSTG .
Warisan
Antarmuka IStorage mewarisi dari antarmuka IUnknown . IStorage juga memiliki jenis anggota ini:
Metode
Antarmuka IStorage memiliki metode ini.
| IStorage::Commit Metode Penerapan memastikan bahwa setiap perubahan yang dilakukan pada objek penyimpanan terbuka dalam mode yang ditransaksikan tercermin dalam penyimpanan induk. |
| IStorage::CopyTo Menyalin seluruh konten objek penyimpanan terbuka ke objek penyimpanan lain. |
| IStorage::CreateStorage Membuat dan membuka objek penyimpanan baru yang ditumpuk dalam objek penyimpanan ini dengan nama yang ditentukan dalam mode akses yang ditentukan. |
| IStorage::CreateStream Membuat dan membuka objek stream dengan nama yang ditentukan yang terkandung dalam objek penyimpanan ini. |
| IStorage::D estroyElement Menghapus penyimpanan atau aliran yang ditentukan dari objek penyimpanan ini. |
| IStorage::Enumelements Metode EnumElements mengambil pointer ke objek enumerator yang dapat digunakan untuk menghitung objek penyimpanan dan aliran yang terkandung dalam objek penyimpanan ini. |
| IStorage::MoveElementTo Metode MoveElementTo menyalin atau memindahkan substorase atau streaming dari objek penyimpanan ini ke objek penyimpanan lain. |
| IStorage::OpenStorage Membuka objek penyimpanan yang ada dengan nama yang ditentukan dalam mode akses yang ditentukan. |
| IStorage::OpenStream Membuka objek aliran yang ada dalam objek penyimpanan ini dalam mode akses yang ditentukan. |
| IStorage::RenameElement Metode RenameElement mengganti nama substorage atau aliran yang ditentukan dalam objek penyimpanan ini. |
| IStorage::Kembalikan Metode Kembali membuang semua perubahan yang telah dilakukan pada objek penyimpanan sejak operasi penerapan terakhir. |
| IStorage::SetClass Metode SetClass menetapkan pengidentifikasi kelas yang ditentukan (CLSID) ke objek penyimpanan ini. |
| IStorage::SetElementTimes Metode SetElementTimes mengatur waktu modifikasi, akses, dan pembuatan elemen penyimpanan yang ditentukan, jika sistem file yang mendasarinya mendukung metode ini. |
| IStorage::SetStateBits Metode SetStateBits menyimpan hingga 32 bit informasi status dalam objek penyimpanan ini. |
| IStorage::Stat Metode Stat mengambil struktur STATSTG untuk objek penyimpanan terbuka 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 | objidl.h |