IOleCacheControl

The IOleCacheControl interface provides proper maintenance of caches. It maintains the caches by connecting the running object’s IDataObject implementation to the cache, allowing the cache to receive notifications from the running object.

When to Implement

The OLE-provided implementation is used by most handlers and in-process servers. You can get a pointer to the OLE data cache object through a call to CreateDataCache.

When to Use

Object handlers and in-process servers use this interface internally to connect the cache part of the handler to the IDataObject implementation on the running object. Container applications have no need for this interface; they use IRunnableObject or OleRun instead.

Methods in VTable Order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments the reference count.

Release

Decrements the reference count.

IOleCacheControl Methods

Description

OnRun

Notifies the cache when the data object is running so the cache object can establish advise sinks as needed.

OnStop

Notifies the cache to terminate any existing advise sinks.