IOleCacheControl Interface

IID_IOleCacheControl

{00000129-0000-0000-C000-000000000046}

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.

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.

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 reference count.

Release

Decrements 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.

OnRun

FUNCTION IOleCacheControl_OnRun ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL pDataObject AS DWORD _

  ) AS LONG
 

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IOleCacheControl_OnRun (pthis, pDataObject) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

OnStop

FUNCTION IOleCacheControl_OnStop ( _

  BYVAL pthis AS DWORD PTR _

  ) AS LONG
 

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IOleCacheControl_OnStop (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION