acmilan作者
11年3个月前修改于 11年3个月前IP:四川
789538
2楼
三、使用ATL简化编程

使用原生的COM接口的话,需要自己管理生存期,上边的程序很简单并无大碍,但稍微复杂一点的程序便十分棘手,还容易出错。为了减少编程人员的负担,使COM编程更加方便和可靠,微软的ATL(活动模板库)为我们准备了一个COM接口的智能指针:CComPtr<T>。

CComPtr<T>的主要作用是容纳接口的指针T*。CComPtr<T>在赋值时会自动进行Release和AddRef,在出作用域时自动进行Release,实现了自动管理生命周期。它同时重载了模板化赋值运算符,自动调用QueryInterface。还简化了CoCreateInstance等函数的调用。

首先,使用ATL要使用C++编译器编译,并且包含头文件atlbase.h:
#include <atlbase.h>

CComPtr<T>的使用很简单。建立一个空指针的操作如下:
CComPtr<ISpVoice> pISpVoice; // 自动设为NULL

在CComPtr<T>上建立新实例(注意是点运算符,不是箭头):
hr = pISpVoice.CoCreateInstance(CLSID_SpVoice); // 省略了后两个参数:pUnkOuter=NULL, dwClsContext=CLSCTX_ALL

调用成员函数(箭头运算符):
hr = pISpVoice->Speak(L"电脑在说话!", SPF_DEFAULT, NULL);

赋值:
pISpVoice2 = pISpVoice; // 自动调用pISpVoice2的Release和pISpVoice的AddRef

转换接口类型:
CComPtr<IUnknown> pUnk = pISpVoice; // 自动调用QueryInterface,失败则返回NULL

取地址:
pUnk = NULL; // 作为输出(out)参数必须先置为NULL
pISpVoice.QueryInterface(&pUnk);
// &运算符获得pUnk.p成员变量的地址

CComPtr<T>在离开作用域时会自动释放。但有时需要手动释放,比如需要再次调用CoCreateInstance时。手动释放有两种方法:
1.赋值NULL
pISpVoice = NULL; // 自动调用Release
2.调用.Release(),注意不是->Release(),它会同时将值设为NULL,防止悬空指针产生
pISpVoice.Release(); // 调用Release,同时设为NULL

有了CComPtr<T>,我们的程序可以简化为这样。可以看到,我们已经不再需要手工释放COM组件了,CoCreateInstance的调用也大为简化:
#include <stdio.h>
#include <stdlib.h>
          
#include <windows.h> // 使用COM组件需要包含windows.h
#include <sapi.h> // 使用ISpVoice语音组件需要包含sapi.h
#include <atlbase.h> // 使用CComPtr<t>需要包含atlbase.h
          
#define ValidateHR(hr) \
    if (FAILED(hr)) { \
        printf("HRESULT错误:%p,在%s第%d行\n", hr, __FILE__, __LINE__); \
        exit(1); \
    }
          
int main()
{
    HRESULT hr = CoInitialize(0); // 初始化COM环境,参数保留,必须为0
    ValidateHR(hr);
          
    {
        // 建立ISpVoice接口实例(组件ID为CLSID_SpVoice)
        CComPtr<ispvoice> pISpVoice;
        hr = pISpVoice.CoCreateInstance(CLSID_SpVoice); // 点运算符。省略了后两个参数:NULL, CLSCTX_ALL
        ValidateHR(hr);
          
        // 调用ISpVoice的Speak成员函数
        hr = pISpVoice->Speak(L"电脑在说话!", SPF_DEFAULT, NULL);
        ValidateHR(hr);
          
    } // pISpVoice在作用域边界会自动释放
              
    CoUninitialize(); // 卸载COM环境
    return 0;
}</ispvoice></t></atlbase.h></sapi.h></windows.h></stdlib.h></stdio.h>

为了方便起见,以后的程序均使用CComPtr<IMyInterface>,不再使用IMyInterface*。
评论
文号 / 789538

千古风流
名片发私信
学术分 4
总主题 466 帖总回复 2942 楼拥有证书:进士 学者 笔友
注册于 2009/05/30 21:22:42最后登录 2019/01/31 17:16:38
主体类型:个人
所属领域:无
认证方式:邮箱
IP归属地:0

个人简介

暂未填写
笔记
{{note.content}}
{{n.user.username}}
{{fromNow(n.toc)}} {{n.status === noteStatus.disabled ? "已屏蔽" : ""}} {{n.status === noteStatus.unknown ? "正在审核" : ""}} {{n.status === noteStatus.deleted ? '已删除' : ''}}
  • 编辑
  • 删除
  • {{n.status === 'disabled' ? "解除屏蔽" : "屏蔽" }}
我也是有底线的