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

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)

 

 

Show: