|
IOleCache2::DiscardCache
Discards the caches in memory.
HRESULT DiscardCache(
DWORD dwDiscardOptions
| //Save data or discard it
| );
|
|
Parameter
dwDiscardOptions
Indicates whether data is to be saved prior to the discard. Valid values are
from the enumeration DISCARDCACHE. Containers that have drawn a large object and need to free up memory may
want to 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(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 Values
S_OK
The cache(s) were discarded according to the value specified in dwDiscardOptions.
E_INVALIDARG
One or more arguments are invalid.
E_UNEXPECTED
An unexpected error occurred.
OLE_E_NOSTORAGE
There is no storage available for saving the data in the cache.
STG_E_MEDIUMFULL
The storage medium is full.
Comments
The IOleCache2::DiscardCache method is commonly used to handle low memory conditions by freeing memory
currently being used by presentation caches.
Once discarded, the cache will satisfy subsequent IDataObject::GetData calls by reverting to disk-based data.
See Also
DISCARDCACHE, IOleCache, IOleCacheControl
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
