IOleCacheControl::OnRun 方法 (oleidl.h)

通知缓存数据源对象已进入运行状态,以便缓存对象可以根据需要建立建议接收器。

语法

HRESULT OnRun(
  [in] LPDATAOBJECT pDataObject
);

参数

[in] pDataObject

指向正在进入运行状态的对象上的 IDataObject 接口的指针。

返回值

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

返回代码 说明
E_INVALIDARG
其中一个参数无效。
E_UNEXPECTED
发生意外错误。
E_OUTOFMEMORY
可用于此操作的内存不足。

注解

调用 OnRun 时,缓存会根据需要设置与源数据对象的咨询连接,以便它可以接收通知。 调用 IOleCacheControl::OnStop 时,在正在运行的对象和缓存之间创建的咨询连接将被销毁。

某些对象处理程序或进程内服务器可能会被动地使用缓存,而不是调用 OnRun。 这些应用程序必须在必要时调用 IOleCache2::UpdateCacheIOleCache::InitCacheIOleCache::SetData 来填充缓存,以确保缓存得到更新。

OnRun 不会在 pDataObject 中传递的指向 IDataObject 的指针上添加引用计数。 由于 OleRun 的调用方负责确保 pDataObject 指针的生存期持续到调用 OnStop ,因此调用方必须持有指向相关数据对象上的 IDataObject 的指针。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 oleidl.h

另请参阅

IOleCache2::UpdateCache

IOleCacheControl

IOleCacheControl::OnStop