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。 其他可能的值包括以下内容。

返回代码 说明
E_OUTOFMEMORY
 操作的内存不足。
E_INVALIDARG
 一个或多个参数无效。
E_UNEXPECTED
 发生了意外错误。

注解

OleNoteObjectVisible 函数调用 CoLockObjectExternal 函数。 它作为单独的函数提供，以强化在对象对用户可见时锁定该对象的需求，并在对象变为不可见时释放该对象。 这会代表用户创建强锁，以确保对象在可见时无法由其容器关闭。

要求

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

另请参阅

CoLockObjectExternal