OleNoteObjectVisible 函数 (ole2.h)
递增或递减使对象保持运行状态的外部引用。
语法
HRESULT OleNoteObjectVisible(
[in] LPUNKNOWN pUnknown,
[in] BOOL fVisible
);
参数
[in] pUnknown
指向要锁定或解锁的对象上的 IUnknown 接口的指针。
[in] fVisible
对象是否可见。 如果为 TRUE，则无论外部或内部 IUnknown：：AddRef 和 IUnknown：：Release 操作、注册或吊销如何，OLE 都会递增引用计数，使对象保持可见和活动状态。 如果 为 FALSE，则 OLE 释放其保留 (递减引用计数) 并且对象可以关闭。
返回值
此函数在成功时返回S_OK。 其他可能的值包括以下内容。
| 返回代码 | 说明 |
|---|---|
|
操作的内存不足。 |
|
一个或多个参数无效。 |
|
发生了意外错误。 |
注解
OleNoteObjectVisible 函数调用 CoLockObjectExternal 函数。 它作为单独的函数提供，以强化在对象对用户可见时锁定该对象的需求，并在对象变为不可见时释放该对象。 这会代表用户创建强锁，以确保对象在可见时无法由其容器关闭。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | ole2.h |
| Library | Ole32.lib |
| DLL | Ole32.dll |