Función PSCreateMemoryPropertyStore (propsys.h)

Crea un almacén de propiedades en memoria.

Sintaxis

PSSTDAPI PSCreateMemoryPropertyStore(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parámetros

[in] riid

Tipo: REFIID

Referencia al identificador de interfaz solicitado.

[out] ppv

Tipo: void**

Cuando esta función vuelve, contiene un puntero a la interfaz deseada, normalmente IPropertyStore o IPersistSerializedPropStorage.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Esta función crea un objeto de almacén de propiedades en memoria que implementa IPropertyStore, INamedPropertyStore, IPropertyStoreCache, IPersistStream, IPropertyBag e IPersistSerializedPropStorage.

Este es el mismo objeto identificado por InMemoryPropertyStore (CLSID_InMemoryPropertyStore) y InMemoryPropertyStoreMarshalByValue (CLSID_InMemoryPropertyStoreMarshalByValue), construido con CoCreateInstance.

InMemoryPropertyStoreMarshalByValue se puede usar en diseños que pasan objetos entre procesos para que sean más eficientes. Implementa las referencias por valor, creando una copia del objeto en el contexto no marshal y evita la comunicación entre procesos que puede ser costosa.

El almacén de propiedades de memoria no tiene ninguna representación presistente, por lo que las llamadas a IPropertyStore::Commit son una operación sin operación.

El almacén de propiedades de memoria es seguro para subprocesos y ágil.

Ejemplos

En el ejemplo siguiente se muestra cómo usar 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));

Requisitos

Consulte también

PSCreateMultiplexPropertyStore