OleLockRunning 函数 (ole2.h)

将已运行的对象锁定到其运行状态,或将其从其运行状态中解锁。

语法

HRESULT OleLockRunning(
  [in] LPUNKNOWN pUnknown,
  [in] BOOL      fLock,
  [in] BOOL      fLastUnlockCloses
);

参数

[in] pUnknown

指向 对象上的 IUnknown 接口的指针,函数使用该指针来查询指向 IRunnableObject 的指针。

[in] fLock

TRUE 将对象锁定到其运行状态。 FALSE 将对象从其运行状态中解锁。

[in] fLastUnlockCloses

TRUE 指定如果正在释放的连接是对象上的最后一个外部锁,则对象应关闭。 FALSE 指定对象应保持打开状态,直到用户或其他进程关闭。

返回值

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

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

注解

OleLockRunning 函数可避免调用 IRunnableObject::LockRunning 方法的麻烦。 可以互换使用 OleLockRunningIRunnableObject::LockRunning 。 使用 pUnknown 参数传入 IUnknown 指针后, OleLockRunning 会查询 IRunnableObject 指针。 如果成功,它将调用 IRunnableObject::LockRunning 并返回调用的结果。

有关使用此函数的详细信息,请参阅 IRunnableObject::LockRunning

要求

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

另请参阅

CoLockObjectExternal

IRunnableObject::LockRunning

OleNoteObjectVisible