Export (0) Print
Expand All

IOleCache2::DiscardCache method

Discards the caches found in memory.

Syntax


HRESULT DiscardCache(
  [in] DWORD dwDiscardOptions
);

Parameters

dwDiscardOptions [in]

A value from the DISCARDCACHE enumeration that indicates whether data is to be saved prior to being discarded. Containers that have drawn a large object and need to free up memory can specify DISCARDCACHE_SAVEIFDIRTY so that the newest presentation is saved for the next time the object must be drawn.

Containers that have activated an embedded object, made some changes, and then called IOleObject::Close with OLECLOSE_NOSAVE to roll back the changes can specify DISCARDCACHE_NOSAVE to ensure that the native and presentation data are not out of synchronization.

Return value

This method returns S_OK on success. Other possible return values include the following.

Return codeDescription
OLE_E_NOSTORAGE

There is no storage available for saving the data in the cache.

STG_E_MEDIUMFULL

The storage medium is full.

 

Remarks

The IOleCache2::DiscardCache method is commonly used to handle low memory conditions by freeing memory currently being used by presentation caches.

After it is discarded, a cache will satisfy subsequent IDataObject::GetData calls by reverting to disk-based data.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.Idl

IID

IID_IOleCache2 is defined as 00000128-0000-0000-C000-000000000046

See also

IOleCache
IOleCache2
IOleCacheControl

 

 

Community Additions

ADD
Show:
© 2015 Microsoft