PSCreateMemoryPropertyStore-Funktion (propsys.h)
Erstellt einen In-Memory-Eigenschaftenspeicher.
Syntax
PSSTDAPI PSCreateMemoryPropertyStore(
[in] REFIID riid,
[out] void **ppv
);
Parameter
[in] riid
Typ: REFIID
Verweis auf die angeforderte Schnittstellen-ID.
[out] ppv
Typ: void**
Wenn diese Funktion zurückgibt, enthält einen Zeiger auf die gewünschte Schnittstelle, in der Regel IPropertyStore oder IPersistSerializedPropStorage.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Funktion erstellt ein In-Memory-Eigenschaftsspeicherobjekt, das IPropertyStore, INamedPropertyStore, IPropertyStoreCache, IPersistStream, IPropertyBag und IPersistSerializedPropStorage implementiert.
Dies ist dasselbe Objekt, das durch InMemoryPropertyStore (CLSID_InMemoryPropertyStore) und InMemoryPropertyStoreMarshalByValue (CLSID_InMemoryPropertyStoreMarshalByValue) identifiziert wird, das mit CoCreateInstance erstellt wurde.
InMemoryPropertyStoreMarshalByValue kann in Designs verwendet werden, die Objekte zwischen Prozessen übergeben, um sie effizienter zu gestalten. Es implementiert Marshall nach Wert, erstellt eine Kopie des Objekts im unmarshalischen Kontext und vermeidet prozessübergreifende Kommunikation, die teuer sein kann.
Der Speicher für Die Speichereigenschaften verfügt über keine vordefinierte Darstellung, sodass Aufrufe von IPropertyStore::Commit ein no-op sind.
Der Speicher für Speichereigenschaften ist threadsicher und agil.
Beispiele
Im folgenden Beispiel wird die Verwendung von InMemoryPropertyStoreveranschaulicht.
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));
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2, Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | propsys.h |
| Bibliothek | Propsys.lib |
| DLL | Propsys.dll (Version 6.0 oder höher) |
| Verteilbare Komponente | Windows Desktop Search (WDS) 3.0 |