Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
InitCache Method
Collapse the table of content
Expand the table of content

IOleCache::InitCache method

Fills the cache as needed using the data provided by the specified data object.

Syntax


HRESULT InitCache(
  [in] IDataObject *pDataObject
);

Parameters

pDataObject [in]

A pointer to the IDataObject interface on the data object from which the cache is to be initialized.

Return value

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

Return codeDescription
E_INVALIDARG

The pointer to the IDataObject interface is invalid.

E_OUTOFMEMORY

Insufficient memory is available for the operation.

OLE_E_NOTRUNNING

The cache is not running.

CACHE_E_NOCACHE_UPDATED

None of the caches were updated.

CACHE_S_SOMECACHES_NOTUPDATED

Only some of the existing caches were updated.

 

Remarks

InitCache is usually used when creating an object from a drag-and-drop operation or from a clipboard paste operation. It fills the cache as needed with presentation data from all the data formats provided by the data object provided on the clipboard or in the drag-and-drop operation. Helper functions like OleCreateFromData or OleCreateLinkFromData call this method when needed. If a container does not use these helper functions to create compound document objects, it can use IOleCache::Cache to set up the cache entries which are then filled by InitCache.

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_IOleCache is defined as 0000011e-0000-0000-C000-000000000046

See also

IOleCache
IOleCache::Cache

 

 

Community Additions

ADD
Show:
© 2015 Microsoft