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

Статья
08/25/2023

Уведомляет объект о том, что он внедрен в контейнер OLE, что гарантирует правильное подсчет ссылок для контейнеров, поддерживающих ссылки на внедренные объекты.

Синтаксис

HRESULT OleSetContainedObject(
  [in] LPUNKNOWN pUnknown,
  [in] BOOL      fContained
);

Параметры

[in] pUnknown

Указатель на интерфейс IUnknown объекта .

[in] fContained

ЗНАЧЕНИЕ TRUE , если объект является внедренным объектом; Значение FALSE в противном случае.

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

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

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

Функция OleSetContainedObject уведомляет объект о том, что он внедрен в контейнер OLE. Реализация OleSetContainedObject была изменена в OLE 2.01, чтобы она совпадала с публикацией интерфейса IRunnableObject . Вы можете использовать метод OleSetContainedObject и метод IRunnableObject::SetContainedObject взаимозаменяемо. Функция OleSetContainedObject запрашивает у объекта указатель на интерфейс IRunnableObject . В случае успешного выполнения функция возвращает результаты вызова IRunnableObject::SetContainedObject.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ole2.h
Библиотека	Ole32.lib
DLL	Ole32.dll
Набор API	ext-ms-win-com-ole32-l1-1-2 (появилось в Windows 10, версия 10.0.10240)

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

IRunnableObject::SetContainedObject

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