CreateDataCache 函数 (objbase.h)

检索指向 OLE 提供的数据缓存实现的新实例的指针。

语法

HRESULT CreateDataCache(
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFCLSID  rclsid,
  [in]  REFIID    iid,
  [out] LPVOID    *ppv
);

parameters

[in] pUnkOuter

如果要将缓存创建为聚合的一部分,则指向聚合的控制 IUnknown 的指针。 否则,参数应为 NULL

[in] rclsid

用于生成图标标签的 CLSID。 此值通常是CLSID_NULL。

[in] iid

对调用方要用于与缓存通信的接口标识符的引用。 此值通常IID_IOleCache (在 OLE 标头中定义,以等于 IOleCache) 的接口标识符。

[out] ppv

接收 riid 中请求的接口指针的指针变量的地址。 成功返回后,*ppvObj 包含指向提供的缓存对象的请求接口指针。

返回值

此函数在成功时返回S_OK。 其他可能的值包括以下内容。

返回代码 说明
E_NOINTERFACE
对象不支持 riid 表示的接口。 参数 ppvObj 设置为 NULL
E_OUTOFMEMORY
操作的内存不足。
E_INVALIDARG
一个或多个参数无效。

注解

CreateDataCache 创建的缓存对象支持用于控制缓存的 IOleCacheIOleCache2IOleCacheControl 接口。 它还支持 IPersistStorageIDataObject (,而不建议接收器) 、 IViewObjectIViewObject2 接口。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 objbase.h
Library Ole32.lib
DLL Ole32.dll
API 集 Windows 10版本 10.0.15063 中引入的 ext-ms-win-com-ole32-l1-1-5 ()

请参阅

IOleCache

IOleCache2

IOleCacheControl