Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Fills the cache as needed using the data provided by the specified data object.
Syntax
HRESULT InitCache(
[in] IDataObject *pDataObject
);
Parameters
[in] pDataObject
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 code | Description |
|---|---|
|
The pointer to the IDataObject interface is invalid. |
|
Insufficient memory is available for the operation. |
|
The cache is not running. |
|
None of the caches were updated. |
|
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | oleidl.h |