Share via


IPersistStreamInitImpl Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at IPersistStreamInitImpl Class.

This class implements IUnknown and provides a default implementation of the IPersistStreamInit interface.

Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

Syntax

template<class T>  
class ATL_NO_VTABLE IPersistStreamInitImpl 
   : public IPersistStreamInit

Parameters

T
Your class, derived from IPersistStreamInitImpl.

Members

Public Methods

Name Description
IPersistStreamInitImpl::GetClassID Retrieves the object's CLSID.
IPersistStreamInitImpl::GetSizeMax Retrieves the size of the stream needed to save the object's data. The ATL implementation returns E_NOTIMPL.
IPersistStreamInitImpl::InitNew Initializes a newly created object.
IPersistStreamInitImpl::IsDirty Checks whether the object's data has changed since it was last saved.
IPersistStreamInitImpl::Load Loads the object's properties from the specified stream.
IPersistStreamInitImpl::Save Saves the object's properties to the specified stream.

Remarks

The IPersistStreamInit interface allows a client to request that your object loads and saves its persistent data to a single stream. Class IPersistStreamInitImpl provides a default implementation of this interface and implements IUnknown by sending information to the dump device in debug builds.

Related Articles ATL Tutorial, Creating an ATL Project

Inheritance Hierarchy

IPersistStreamInit

IPersistStreamInitImpl

Requirements

Header: atlcom.h

IPersistStreamInitImpl::GetClassID

Retrieves the object's CLSID.

STDMETHOD(GetClassID)(CLSID* pClassID);

Remarks

See IPersist::GetClassID in the Windows SDK.

IPersistStreamInitImpl::GetSizeMax

Retrieves the size of the stream needed to save the object's data.

STDMETHOD(GetSizeMax)(ULARGE_INTEGER FAR* pcbSize);

Return Value

Returns E_NOTIMPL.

Remarks

See IPersistStreamInit::GetSizeMax in the Windows SDK.

IPersistStreamInitImpl::InitNew

Initializes a newly created object.

STDMETHOD(InitNew)();

Remarks

See IPersistStreamInit::InitNew in the Windows SDK.

IPersistStreamInitImpl::IsDirty

Checks whether the object's data has changed since it was last saved.

STDMETHOD(IsDirty)();

Remarks

See IPersistStreamInit::IsDirty in the Windows SDK.

IPersistStreamInitImpl::Load

Loads the object's properties from the specified stream.

STDMETHOD(Load)(LPSTREAM pStm);

Remarks

ATL uses the object's property map to retrieve this information.

See IPersistStreamInit::Load in the Windows SDK.

IPersistStreamInitImpl::Save

Saves the object's properties to the specified stream.

STDMETHOD(Save)(LPSTREAM pStm, BOOL fClearDirty);

Remarks

ATL uses the object's property map to store this information.

See IPersistStreamInit::Save in the Windows SDK.

See Also

Storages and Streams
Class Overview