CComPolyObject 类

注释

活动模板库(ATL)将继续受到支持。 但是,我们不再添加功能或更新文档。

此类为聚合或非聚合对象实现 IUnknown。

语法

template<class contained>
class CComPolyObject : public IUnknown,
      public CComObjectRootEx<contained::_ThreadModel::ThreadModelNoCS>

参数

contained
类派生自 CComObjectRoot 或 CComObjectRootEx,以及对象上你要支持的任何其他接口。

成员

公共构造函数

名称 描述
CComPolyObject::CComPolyObject 构造函数。
CComPolyObject::~CComPolyObject 析构函数。

公共方法

名称 描述
CComPolyObject::AddRef 递增对象的引用计数。
CComPolyObject::CreateInstance (静态)允许在不产生 CoCreateInstance 开销的情况下创建新的 CComPolyObject <contained>对象。
CComPolyObject::FinalConstruct 对 m_contained 执行最终的初始化。
CComPolyObject::FinalRelease 对 m_contained 执行最终的析构。
CComPolyObject::QueryInterface 检索指向所请求的接口的指针。
CComPolyObject::Release 递减对象的引用计数。

公共数据成员

名称 描述
CComPolyObject::m_contained 如果对象已聚合,则将 IUnknown 调用委托给外部未知;如果对象未聚合,则委托给对象的 IUnknown。

注解

CComPolyObject 为聚合或非聚合对象实现 IUnknown。

创建 CComPolyObject 的实例时,将检查外部未知的值。 如果为 NULL,则 IUnknown 为非聚合对象实现。 如果外部未知不为 NULL,则会为聚合对象实现 IUnknown。

使用 CComPolyObject 的优点是,避免在模块中同时使用 CComAggObject 和 CComObject 处理聚合和非聚合事例。 单个 CComPolyObject 对象处理这两种情况。 这意味着模块中只有一个 vtable 副本和一个函数副本。 如果 vtable 很大,这可以大大减小模块大小。 但是,如果 vtable 较小,则使用 CComPolyObject 可能会导致模块大小略大,因为它未针对聚合或非聚合对象进行优化,如 CComAggObject 和 CComObject 所示。

如果在对象的类定义中指定了 DECLARE_POLY_AGGREGATABLE 宏,则将使用 CComPolyObject 来创建对象。 如果使用 ATL 项目向导创建完全控件或 Internet Explorer 控件,则会自动声明 DECLARE_POLY_AGGREGATABLE。

如果已聚合,则 CComPolyObject 对象有其自己的 IUnknown(独立于外部对象的 IUnknown),并保留其自己的引用计数。 CComPolyObject 使用 CComContainedObject 来委托给外部未知。

有关聚合的详细信息,请参阅 ATL COM 对象的基础知识一文。

继承层次结构

CComObjectRootBase

CComObjectRootEx

IUnknown

CComPolyObject

要求

标头:atlcom.h

CComPolyObject::AddRef

递增对象的引用计数。

STDMETHOD_(ULONG, AddRef)();

返回值

可用于诊断或测试的值。

CComPolyObject::CComPolyObject

构造函数。

CComPolyObject(void* pv);

参数

pv
[in] 如果要聚合对象,则为指向外部未知的指针;如果对象未聚合,则为 NULL。

注解

初始化 CComContainedObject 数据成员 m_contained,并递增模块锁计数。

析构函数递减模块锁计数。

CComPolyObject::~CComPolyObject

析构函数。

~CComPolyObject();

注解

释放所有已分配的资源、调用 FinalRelease,并递减模块锁计数。

CComPolyObject::CreateInstance

允许在不产生 CoCreateInstance 开销的情况下创建新的 CComPolyObject<contained> 对象。

static HRESULT WINAPI CreateInstance(
    LPUNKNOWN pUnkOuter,
    CComPolyObject<contained>** pp);

参数

pp
[out]指向 CComPolyObject<>指针。 如果 CreateInstance 不成功,则会将 pp 设置为 NULL。

返回值

标准 HRESULT 值。

注解

返回的对象的引用计数为零,因此请立即调用 AddRef,然后在完成后使用 Release 释放对象指针上的引用。

如果不需要直接访问对象,但仍希望创建一个新对象而没有 CoCreateInstance 开销,请改用 CComCoClass::CreateInstance。

CComPolyObject::FinalConstruct

在对象构造的最后阶段调用,此方法对 m_contained 数据成员执行任何最终初始化。

HRESULT FinalConstruct();

返回值

标准 HRESULT 值。

CComPolyObject::FinalRelease

在对象析构期间调用,此方法释放 m_contained 数据成员。

void FinalRelease();

CComPolyObject::m_contained

从类派生的 CComContainedObject 对象。

CComContainedObject<contained> m_contained;

参数

contained
[in] 类派生自 CComObjectRoot 或 CComObjectRootEx,以及对象上你要支持的任何其他接口。

注解

如果对象已聚合,则通过 IUnknown 进行的 m_contained 调用将委托给外部未知;如果对象未聚合,则委托给对象的 IUnknown。

CComPolyObject::QueryInterface

检索指向所请求的接口的指针。

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

参数

Q
COM 接口。

iid
[in] 请求的接口的标识符。

ppvObject
[out] 一个指向 iid 所标识的接口指针的指针。 如果对象不支持此接口,则 ppvObject 设置为 NULL。

pp
[out] 一个指向 __uuidof(Q) 所标识的接口的指针。

返回值

标准 HRESULT 值。

注解

对于已聚合对象,如果请求的接口为 IUnknown,则 QueryInterface 会返回指向已聚合对象自己的 IUnknown 的指针,并递增引用计数。 否则,此方法会通过 CComContainedObject 数据成员 m_contained 来查询接口。

CComPolyObject::Release

递减对象的引用计数。

STDMETHOD_(ULONG, Release)();

返回值

在调试生成中,Release 返回可用于诊断或测试的值。 在非调试生成中,Release 始终返回 0。

另请参阅

CComObjectRootEx 类
DECLARE_POLY_AGGREGATABLE
类概述