StgCreatePropSetStg

Creates a property set storage object from a specified storage object. The property set storage object supplies the system-provided, standalone implementation of the IPropertySetStorage interface.

HRESULT StgCreatePropSetStg(
  IStorage* pStorage,  //Pointer to a storage object
  DWORD dwReserved,    //Reserved; must be zero
  IPropertySetStorage** ppPropSetStg
                       //Address of output variable that receives 
                       // IPropertySetStorage interface pointer
);

Parameter

pStorage: [in] Pointer to the storage object that contains one or more property sets.
dwReserved: Reserved for future use; must be zero.
ppPropSetStg: [out] Address of IPropertySetStorage* pointer variable that receives the interface pointer to the property set storage object.

Return Values

This function supports the standard return value E_INVALIDARG as well as the following:

S_OK: The property set storage object was successfully created.

Remarks

StgCreatePropSetStg calls IUnknown::AddRef on the storage object specified by pStorage. The caller is responsible for releasing the object when it is no longer needed.

Programming Information

Windows NT	4.0/SP2 or with IPROP.DLL
Win95	Yes; requires IPROP.DLL
Win32s	No
Unicode	Yes
Import Library	IPROP.DLL
Header File	IPROPIDL.H

QuickInfo