CComPtr 和 CComQIPtr 是 Active Template Library (ATL) 中提供的智能指针类,它们用于管理 COM 接口指针的生命周期。COM(Component Object Model)是微软提供的一种用于创建二进制软件组件的规范,这些组件可以在不同的应用程序和操作系统之间互操作。
很多老系统会使用COM组件,并建立ATL库工程,这个时候用的智能指针就是CComPtr和CComQIPtr,千万不要再说自己没接触过智能指针了,虽然不是流行的shared_ptr之类的智能指针。
CComPtr
CComPtr 是一个模板类,它封装了一个指向 COM 接口的指针,并提供了自动引用计数(Reference Counting)和接口指针释放的功能。这确保了当 CComPtr 对象离开其作用域或被重置时,它所持有的 COM 接口指针会被正确地释放。
使用 CComPtr 的好处包括:
- 自动管理引用计数:当你通过 CComPtr 调用一个 COM 对象的 AddRef 方法时,CComPtr 会自动跟踪引用计数。当 CComPtr 对象被销毁或重置时,它会调用 Release 方法来减少引用计数,并在引用计数为零时释放 COM 对象。
- 减少内存泄漏:由于 CComPtr 自动管理 COM 接口指针的生命周期,因此可以显著减少由于忘记释放 COM 对象而导致的内存泄漏。
- 简化代码:使用 CComPtr 可以使代码更简洁,更易于理解和维护。
CComQIPtr
-
CComQIPtr 是 CComPtr 的一个变体,它提供了对 COM 接口的“查询接口”(Query Interface, QI)的支持。查询接口是 COM 中的一个重要概念,它允许一个 COM 对象暴露多个接口,而客户端可以通过查询接口来获取这些接口的指针。
-
CComQIPtr 模板类接受两个参数:一个是目标 COM 接口的类型,另一个是源 COM 接口的类型(即你已经有其指针的接口)。当你通过 CComQIPtr 访问一个接口时,它首先会尝试从源接口指针中查询目标接口。如果查询成功,则 CComQIPtr 会持有这个新接口的指针,并像 CComPtr 一样管理它。
使用 CComQIPtr 的好处包括:
- 简化查询接口:通过 CComQIPtr,你可以更简洁地查询和使用 COM 对象的多个接口。
- 自动管理接口指针:与 CComPtr 类似,CComQIPtr 也自动管理接口指针的生命周期,减少内存泄漏的风险。
- 类型安全:由于 CComQIPtr 是模板类,因此它提供了类型安全,确保你只能访问正确的接口方法。
使用示例
下面是一个简单的示例,演示了如何使用 CComPtr 和 CComQIPtr:
#include <atlbase.h>
#include <atlcom.h>
// 假设 IMyInterface1 和 IMyInterface2 是两个 COM 接口
extern CComPtr<IMyInterface1> pInterface1; // 假设已经初始化为一个有效的 COM 对象
// 使用 CComPtr
{
CComPtr<IMyInterface1> pClone1 = pInterface1; // 复制指针,引用计数增加
// ... 使用 pClone1 ...
// 当 pClone1 离开作用域时,它会自动调用 Release
}
// 使用 CComQIPtr 查询接口
{
CComQIPtr<IMyInterface2> pInterface2 = pInterface1; // 尝试从 pInterface1 查询 IMyInterface2
if (pInterface2) // 如果查询成功,则 pInterface2 非空
{
// ... 使用 pInterface2 ...
// 当 pInterface2 离开作用域时,它会自动调用 Release(如果查询成功)
}
}
请注意,在使用 ATL 智能指针之前,你需要包含相应的 ATL 头文件(如 atlbase.h 和 atlcom.h),并确保你的项目链接到 ATL 库。