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

Функция OleNoteObjectVisible (ole2.h)

  • Статья

Увеличивает или уменьшает внешнюю ссылку, которая сохраняет объект в запущенном состоянии.

Синтаксис

HRESULT OleNoteObjectVisible(
  [in] LPUNKNOWN pUnknown,
  [in] BOOL      fVisible
);

Параметры

[in] pUnknown

Указатель на интерфейс IUnknown для объекта, который должен быть заблокирован или разблокирован.

[in] fVisible

Указывает, является ли объект видимым. Если задано значение TRUE, OLE увеличивает число ссылок, чтобы объект был видимым и активным независимо от операций, регистраций или отзыва IUnknown::AddRef и IUnknown::Release . Если значение РАВНО FALSE, OLE освобождает удержание (уменьшает количество ссылок), и объект можно закрыть.

Возвращаемое значение

Эта функция возвращает S_OK об успешном выполнении. Ниже перечислены другие возможные значения.

Код возврата Описание
E_OUTOFMEMORY
 Недостаточно памяти для операции.
E_INVALIDARG
 Один или несколько параметров являются недопустимыми.
E_UNEXPECTED
 Произошла непредвиденная ошибка.

Комментарии

Функция OleNoteObjectVisible вызывает функцию CoLockObjectExternal . Он предоставляется в виде отдельной функции для усиления необходимости блокировки объекта, когда он становится видимым для пользователя, и освобождения объекта, когда он становится невидимым. Это создает сильную блокировку от имени пользователя, чтобы гарантировать, что объект не может быть закрыт его контейнером, пока он виден.

Требования

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

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

CoLockObjectExternal