Функция 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

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

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