Windows Dev Center

IPersistSerializedPropStorage::GetPropertyStorage method

Gets the serialized property storage data from the property store instance.

Syntax


HRESULT GetPropertyStorage(
  [out] SERIALIZEDPROPSTORAGE **ppsps,
  [out] DWORD                 *pcb
);

Parameters

ppsps [out]

Type: SERIALIZEDPROPSTORAGE**

When this method returns, contains the address of a pointer to the serialized property storage data.

pcb [out]

Type: DWORD*

When this method returns, contains the count of bytes contained in the serialized property storage data pointed to by ppsps.

Return value

Type: HRESULT

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

Remarks

The SERIALIZEDPROPSTORAGE type is defined in Propsys.h as an incomplete type. It should be treated as an array of BYTE values; the format of the returned data is not specified. The contents of the SERIALIZEDPROPSTORAGE structure are suitable for persisting to disk or other storage and can be used to initialize another property store through IPersistSerializedPropStorage::SetPropertyStorage.

Note  It is the responsibility of the application that calls IPersistSerializedPropStorage::GetPropertyStorage to later call CoTaskMemFree to release the memory referred to by ppsps when it is no longer needed.
 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Propsys.h

IDL

Propsys.idl

 

 

Community Additions

ADD
Show:
© 2015 Microsoft