IOleCacheControl::OnRun 方法 (oleidl.h)
通知缓存数据源对象已进入运行状态,以便缓存对象可以根据需要建立建议接收器。
语法
HRESULT OnRun(
[in] LPDATAOBJECT pDataObject
);
参数
[in] pDataObject
指向正在进入运行状态的对象上的 IDataObject 接口的指针。
返回值
此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
其中一个参数无效。 |
|
发生意外错误。 |
|
可用于此操作的内存不足。 |
注解
调用 OnRun 时,缓存会根据需要设置与源数据对象的咨询连接,以便它可以接收通知。 调用 IOleCacheControl::OnStop 时,在正在运行的对象和缓存之间创建的咨询连接将被销毁。
某些对象处理程序或进程内服务器可能会被动地使用缓存,而不是调用 OnRun。 这些应用程序必须在必要时调用 IOleCache2::UpdateCache、 IOleCache::InitCache 或 IOleCache::SetData 来填充缓存,以确保缓存得到更新。
OnRun 不会在 pDataObject 中传递的指向 IDataObject 的指针上添加引用计数。 由于 OleRun 的调用方负责确保 pDataObject 指针的生存期持续到调用 OnStop ,因此调用方必须持有指向相关数据对象上的 IDataObject 的指针。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | oleidl.h |