Skip to content

Latest commit

 

History

History
137 lines (115 loc) · 3.68 KB

nf-oleidl-iolecache-initcache.md

File metadata and controls

137 lines (115 loc) · 3.68 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:oleidl.IOleCache.InitCache
IOleCache::InitCache (oleidl.h)
Fills the cache as needed using the data provided by the specified data object.
IOleCache interface [COM]
InitCache method
IOleCache.InitCache
IOleCache::InitCache
InitCache
InitCache method [COM]
InitCache method [COM]
IOleCache interface
_ole_iolecache_initcache
com.iolecache_initcache
oleidl/IOleCache::InitCache
com\iolecache_initcache.htm
com
4b1f2fb6-636c-47dd-8f89-884f7b4f3977
12/05/2018
IOleCache interface [COM],InitCache method, IOleCache.InitCache, IOleCache::InitCache, InitCache, InitCache method [COM], InitCache method [COM],IOleCache interface, _ole_iolecache_initcache, com.iolecache_initcache, oleidl/IOleCache::InitCache
oleidl.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
OleIdl.Idl
Windows
19H1
IOleCache::InitCache
oleidl/IOleCache::InitCache
c++
APIRef
kbSyntax
COM
OleIdl.h
IOleCache.InitCache

IOleCache::InitCache

-description

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

-parameters

-param pDataObject [in]

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

-returns

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

Return code Description
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.

-see-also

IOleCache

IOleCache::Cache