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

Функция CoGetObjectContext (combaseapi.h)

  • Статья

Возвращает контекст для текущего объекта .

Синтаксис

HRESULT CoGetObjectContext(
  [in]  REFIID riid,
  [out] LPVOID *ppv
);

Параметры

[in] riid

Ссылка на идентификатор интерфейса, реализованного в объекте контекста.

Для объектов, работающих в com-приложениях, доступны IID_IComThreadingInfo, IID_IContext и IID_IContextCallback.

Для объектов, выполняющихся в приложениях COM+, доступны IID_IObjectContext, IID_IObjectContextActivity IID_IObjectContextInfo и IID_IContextState.

[out] ppv

Адрес указателя на интерфейс, заданный riid для объекта контекста.

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

Эта функция может возвращать стандартные возвращаемые значения E_OUTOFMEMORY и E_UNEXPECTED, а также следующие значения.

Код возврата Описание
S_OK
 Контекст объекта успешно получен.
E_NOINTERFACE
 Запрошенный интерфейс недоступен.
CO_E_NOTINITIALIZED
 Перед вызовом этой функции необходимо вызвать функцию CoInitializeEx в текущем потоке.

Комментарии

CoGetObjectContext извлекает контекст для объекта, из которого он вызывается, и возвращает указатель на интерфейс, который можно использовать для управления свойствами контекста. Свойства контекста используются для предоставления служб настроенным компонентам, работающим в приложениях COM+.

Для компонентов, работающих в com-приложениях, для доступа к свойствам контекста поддерживаются следующие интерфейсы: IComThreadingInfo, IContext и IContextCallback.

Для компонентов, работающих в приложениях COM+, для доступа к свойствам контекста поддерживаются следующие интерфейсы: IObjectContext, IObjectContextActivity, IObjectContextInfo и IContextState.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header combaseapi.h (включая Objbase.h)
Библиотека Ole32.lib
DLL Ole32.dll

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

Контексты и потоковые модели