PSCreatePropertyStoreFromPropertySetStorage function

Wraps an IPropertySetStorage interface in an IPropertyStore interface.

Syntax

HRESULT PSCreatePropertyStoreFromPropertySetStorage(
  _In_  IPropertySetStorage *ppss,
  _In_  DWORD               grfMode,
  _In_  REFIID              riid,
  _Out_ void                **ppv
);

Parameters

ppss [in]

Type: IPropertySetStorage*

A pointer to an IPropertySetStorage interface.

grfMode [in]

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::SetValueupdate an internal cache of properties, and calls to IPropertyStore::Commitcall the appropriate IPropertySetStorage methods to write out the changed properties.

STGM_WRITE

Not supported.

STGM_READWRITE

Not supported.

riid [in]

Type: REFIID

Reference to an IID.

ppv [out]

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