Leer en inglés

Compartir a través de

PSCreateMemoryPropertyStoreMarshalByValue function

  • Artículo

Creates an in-memory property store that implements marshal by value behavior.

Syntax

c++ 
STDAPI PSCreateMemoryPropertyStoreMarshalByValue(
  _In_  REFIID riid,
  _Out_ void   **ppv
);

Parameters

  • riid [in]
    Type: REFIID

    Reference to the requested interface ID.

  • ppv [out]
    Type: void**

    When this function returns, contains a pointer to the desired interface, typically IPropertyStore or IPersistSerializedPropStorage.

Remarks

The object returned by this API is the same as the one returned by PSCreateMemoryPropertyStore, but it also implements IMarshal to give it marshal by value behavior making it efficient when passed to a COM method that crosses an apartment boundary where marshaling is required. Marshal by value means the receiver of the object gets a copy of the object, not a reference as would normally be the case.

The properties must be serializable – properties containing the VT_UNKNOWN type are not supported across the marshaling boundary.

Requirements

Minimum supported client

Windows XP with SP2, Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 with SP1 [desktop apps only]

Redistributable

Windows Desktop Search (WDS) 3.0

Header

 Propsys.h

Library

 Propsys.lib

DLL

 Propsys.dll (version 6.0 or later)

See also

PSCreateMultiplexPropertyStore