Класс CComContainedObject

Этот класс реализует IUnknown путем делегирования объекту IUnknownвладельца.

Важно!

Этот класс и его члены нельзя использовать в приложениях, выполняемых в среде выполнения Windows.

Синтаксис

template<class Base>
class CComContainedObject : public Base

Параметры

Основание
Класс, производный от CComObjectRoot или CComObjectRootEx.

Участники

Открытые конструкторы

Имя	Описание
CComContainedObject::CComContainedObject	Конструктор. Инициализирует указатель члена на объект IUnknownвладельца.
CComContainedObject::~CComContainedObject	Деструктор

Открытые методы

Имя	Описание
CComContainedObject::AddRef	Увеличивает число ссылок для объекта владельца.
CComContainedObject::GetControllingUnknown	Извлекает объект IUnknownвладельца.
CComContainedObject::QueryInterface	Извлекает указатель на интерфейс, запрошенный для объекта владельца.
CComContainedObject::Release	Уменьшает количество ссылок для объекта владельца.

Замечания

ATL используется CComContainedObject в классах CComAggObject, CComPolyObject и CComCachedTearOffObject. CComContainedObjectреализует IUnknown путем делегирования объекту IUnknownвладельца. (Владелец является внешним объектом агрегирования или объектом, для которого создается интерфейс разрыва.) CComContainedObject вызовы CComObjectRootEx, OuterQueryInterfaceOuterAddRefи OuterRelease, все наследуемые через Base.

Иерархия наследования

Base

CComContainedObject

Требования

Заголовок: atlcom.h

CComContainedObject::AddRef

Увеличивает число ссылок для объекта владельца.

STDMETHOD_(ULONG, AddRef)();

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

Значение, которое может быть полезно для диагностика или тестирования.

CComContainedObject::CComContainedObject

Конструктор.

CComContainedObject(void* pv);

Параметры

Pv
[in] Объект IUnknownвладельца.

Замечания

m_pOuterUnknown Задает указатель члена (унаследованный через Base класс) для pv.

CComContainedObject::~CComContainedObject

Деструктор

~CComContainedObject();

Замечания

Освобождает все выделенные ресурсы.

CComContainedObject::GetControllingUnknown

m_pOuterUnknown Возвращает указатель члена (наследуемый через базовый класс), содержащий объект IUnknownвладельца.

IUnknown* GetControllingUnknown();

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

Объект IUnknownвладельца.

Замечания

Этот метод может быть виртуальным, если Base объявил макрос DECLARE_GET_CONTROLLING_UNKNOWN.

CComContainedObject::QueryInterface

Извлекает указатель на интерфейс, запрошенный для объекта владельца.

STDMETHOD(QueryInterface)(REFIID iid, void** ppvObject);
template <class Q>
HRESULT STDMETHODCALLTYPE QueryInterface(Q** pp);

Параметры

Iid
[in] Идентификатор запрашиваемого интерфейса.

ppvObject
[out] Указатель на указатель интерфейса, определяемый iid. Если объект не поддерживает этот интерфейс, ppvObject имеет значение NULL.

Pp
[out] Указатель на указатель интерфейса, определяемый по типу Q. Если объект не поддерживает этот интерфейс, для pp задано значение NULL.

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

Стандартное значение HRESULT.

CComContainedObject::Release

Уменьшает количество ссылок для объекта владельца.

STDMETHOD_(ULONG, Release)();

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

В отладочных сборках Release возвращает значение, которое может быть полезно для диагностика или тестирования. В сборках, отличных от отладки, Release всегда возвращается значение 0.

См. также

Общие сведения о классе