Поделиться через

Функция 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 . OleLockRunning и IRunnableObject::LockRunning можно использовать взаимозаменяемо. Если указатель IUnknown передается с параметром pUnknown , OleLockRunning запрашивает указатель IRunnableObject . В случае успешного выполнения он вызывает IRunnableObject::LockRunning и возвращает результаты вызова.

Дополнительные сведения об использовании этой функции см. в разделе IRunnableObject::LockRunning.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ole2.h
Библиотека Ole32.lib
DLL Ole32.dll

См. также раздел

CoLockObjectExternal

IRunnableObject::LockRunning

OleNoteObjectVisible