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

Lihat juga

PSCreateMultiplexPropertyStore