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。 其他可能的值包括以下内容。
返回代码 | 说明 |
---|---|
|
操作的内存不足。 |
|
一个或多个参数无效。 |
|
发生了意外错误。 |
注解
OleLockRunning 函数可避免调用 IRunnableObject::LockRunning 方法的麻烦。 可以互换使用 OleLockRunning 和 IRunnableObject::LockRunning 。 使用 pUnknown 参数传入 IUnknown 指针后, OleLockRunning 会查询 IRunnableObject 指针。 如果成功,它将调用 IRunnableObject::LockRunning 并返回调用的结果。
有关使用此函数的详细信息,请参阅 IRunnableObject::LockRunning。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ole2.h |
Library | Ole32.lib |
DLL | Ole32.dll |