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。 其他可能的值包括以下内容。
返回代码 | 说明 |
---|---|
|
对象不支持 riid 表示的接口。 参数 ppvObj 设置为 NULL。 |
|
操作的内存不足。 |
|
一个或多个参数无效。 |
注解
CreateDataCache 创建的缓存对象支持用于控制缓存的 IOleCache、IOleCache2 和 IOleCacheControl 接口。 它还支持 IPersistStorage、 IDataObject (,而不建议接收器) 、 IViewObject 和 IViewObject2 接口。
要求
最低受支持的客户端 | 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 () |