Skip to content

Latest commit

 

History

History
134 lines (104 loc) · 3.92 KB

nf-objbase-createdatacache.md

File metadata and controls

134 lines (104 loc) · 3.92 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 req.apiset
NF:objbase.CreateDataCache
CreateDataCache function (objbase.h)
Retrieves a pointer to a new instance of an OLE-provided implementation of a data cache.
CreateDataCache
CreateDataCache function [COM]
_ole_CreateDataCache
com.createdatacache
objbase/CreateDataCache
com\createdatacache.htm
com
8a64675b-1337-4555-b9a6-e19f9b987ba2
12/05/2018
CreateDataCache, CreateDataCache function [COM], _ole_CreateDataCache, com.createdatacache, objbase/CreateDataCache
objbase.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Ole32.lib
Ole32.dll
Windows
19H1
CreateDataCache
objbase/CreateDataCache
c++
APIRef
kbSyntax
DllExport
Ole32.dll
Ext-MS-Win-OLE32-IE-Ext-l1-1-0.dll
CreateDataCache
ext-ms-win-com-ole32-l1-1-5 (introduced in Windows 10, version 10.0.15063)

CreateDataCache function

-description

Retrieves a pointer to a new instance of an OLE-provided implementation of a data cache.

-parameters

-param pUnkOuter [in]

If the cache is to be created as part of an aggregate, pointer to the controlling IUnknown of the aggregate. If not, the parameter should be NULL.

-param rclsid [in]

CLSID used to generate icon labels. This value is typically CLSID_NULL.

-param iid [in]

Reference to the identifier of the interface the caller wants to use to communicate with the cache. This value is typically IID_IOleCache (defined in the OLE headers to equal the interface identifier for IOleCache).

-param ppv [out]

Address of pointer variable that receives the interface pointer requested in riid. Upon successful return, *ppvObj contains the requested interface pointer to the supplied cache object.

-returns

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

Return code Description
E_NOINTERFACE
The interface represented by riid is not supported by the object. The parameter ppvObj is set to NULL.
E_OUTOFMEMORY
Insufficient memory for the operation.
E_INVALIDARG
One or more parameters are invalid.

-remarks

The cache object created by CreateDataCache supports the IOleCache, IOleCache2, and IOleCacheControl interfaces for controlling the cache. It also supports the IPersistStorage, IDataObject (without advise sinks), IViewObject, and IViewObject2 interfaces.

-see-also

IOleCache

IOleCache2

IOleCacheControl