PSCreatePropertyStoreFromPropertySetStorage function (propsys.h)

Article
02/22/2024

Wraps an IPropertySetStorage interface in an IPropertyStore interface.

Syntax

PSSTDAPI PSCreatePropertyStoreFromPropertySetStorage(
  [in]  IPropertySetStorage *ppss,
  [in]  DWORD               grfMode,
  [in]  REFIID              riid,
  [out] void                **ppv
);

Parameters

[in] ppss

Type: IPropertySetStorage*

A pointer to an IPropertySetStorage interface.

[in] grfMode

Type: DWORD

Specifies the access mode to enforce. grfMode should match the access mode used to open the IPropertySetStorage. Valid values are as follows:

STGM_READ

Calls to IPropertyStore::SetValue update an internal cache of properties, and calls to IPropertyStore::Commit call the appropriate IPropertySetStorage methods to write out the changed properties.

STGM_WRITE

Not supported.

STGM_READWRITE

Not supported.

[in] riid

Type: REFIID

Reference to an IID.

[out] ppv

Type: void**

When this function returns, contains the interface pointer specified in riid.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This function wraps an IPropertySetStorage interface in an IPropertyStore interface. Any value other than STGM_READ for grfMode, causes calls to IPropertyStore::SetValue and IPropertyStore::Commit to fail with STG_E_ACCESSDENIED.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2, Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 with SP1 [desktop apps only]
Target Platform	Windows
Header	propsys.h
Library	Propsys.lib
DLL	Propsys.dll (version 6.0 or later)
Redistributable	Windows Desktop Search (WDS) 3.0

Share via