PSCreateMemoryPropertyStore-Funktion (propsys.h)

  • Artikel

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

Weitere Informationen

PSCreateMultiplexPropertyStore