Fungsi PSCreateMemoryPropertyStore (propsys.h)
Membuat penyimpanan properti dalam memori.
Sintaks
PSSTDAPI PSCreateMemoryPropertyStore(
[in] REFIID riid,
[out] void **ppv
);
Parameter
[in] riid
Jenis: REFIID
Referensi ke ID antarmuka yang diminta.
[out] ppv
Jenis: batal**
Ketika fungsi ini kembali, berisi penunjuk ke antarmuka yang diinginkan, biasanya IPropertyStore atau IPersistSerializedPropStorage.
Nilai kembali
Jenis: HRESULT
Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Fungsi ini membuat objek penyimpanan properti dalam memori yang mengimplementasikan IPropertyStore, INamedPropertyStore, IPropertyStoreCache, IPersistStream, IPropertyBag, dan IPersistSerializedPropStorage.
Ini adalah objek yang sama yang diidentifikasi oleh InMemoryPropertyStore (CLSID_InMemoryPropertyStore) dan InMemoryPropertyStoreMarshalByValue (CLSID_InMemoryPropertyStoreMarshalByValue), dibangun dengan CoCreateInstance.
InMemoryPropertyStoreMarshalByValue dapat digunakan dalam desain yang meneruskan objek antar proses untuk membuatnya lebih efisien. Ini mengimplementasikan marshal berdasarkan nilai, membuat salinan objek dalam konteks yang tidak biasa dan menghindari komunikasi antarproses yang bisa mahal.
Penyimpanan properti memori tidak memiliki representasi yang presisten sehingga panggilan ke IPropertyStore::Commit adalah no-op.
Penyimpanan properti memori aman dan tangkas.
Contoh
Contoh berikut menunjukkan cara menggunakan InMemoryPropertyStore.
auto memPropStore = wil::CoCreateInstance<InMemoryPropertyStore, IPropertyStore>();
auto value = PROPVARIANT{};
value.vt = VT_LPWSTR;
value.pwszVal = L"Title";
THROW_IF_FAILED(memPropStore->SetValue(PKEY_Title, value));
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP dengan SP2, Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 dengan SP1 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | propsys.h |
| Pustaka | Propsys.lib |
| DLL | Propsys.dll (versi 6.0 atau yang lebih baru) |
| Redistribusi | Windows Desktop Search (WDS) 3.0 |