IPersistStorageImpl Class

This class implements the IPersistStorage interface.

Important

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

template < 
class T 
> 
class ATL_NO_VTABLE IPersistStorageImpl : 
public IPersistStorage

Parameters

  • T
    Your class, derived from IPersistStorageImpl.

Members

Public Methods

Name

Description

IPersistStorageImpl::GetClassID

Retrieves the object's CLSID.

IPersistStorageImpl::HandsOffStorage

Instructs the object to release all storage objects and enter HandsOff mode. The ATL implementation returns S_OK.

IPersistStorageImpl::InitNew

Initializes a new storage.

IPersistStorageImpl::IsDirty

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

IPersistStorageImpl::Load

Loads the object's properties from the specified storage.

IPersistStorageImpl::Save

Saves the object's properties to the specified storage.

IPersistStorageImpl::SaveCompleted

Notifies an object that it can return to Normal mode to write to its storage object. The ATL implementation returns S_OK.

Remarks

IPersistStorageImpl implements the IPersistStorage interface, which allows a client to request that your object load and save its persistent data using a storage.

The implementation of this class requires class T to make an implementation of the IPersistStreamInit interface available via QueryInterface. Typically this means that class T should derive from IPersistStreamInitImpl, provide an entry for IPersistStreamInit in the COM map, and use a property map to describe the class's persistent data.

Related Articles ATL Tutorial, Creating an ATL Project

Inheritance Hierarchy

IPersistStorage

IPersistStorageImpl

Requirements

Header: atlcom.h

See Also

Reference

Storages and Streams

IPersistStreamInitImpl Class

IPersistPropertyBagImpl Class

Other Resources

ATL Class Overview