VS2012创建ATL工程及使用MFC测试COM组件

http://blog.csdn.net/pigautumn/article/details/43021085

一、创建ATL工程

1、创建ATL项目，取名为MyATL

2、在ATL项目向导中，勾选【支持MFC】（利用MFC测试用）、【支持 COM+ 1.0】和【支持部件注册器】，其余的选项默认，点击完成。

3、右键工程名称，选择添加类，接下来选择【ATL简单对象】。

4、在【ATL简单对象向导】对话框中填入下面内容（可更改为自己喜欢的类名称），然后直接点击完成。

5、切换到类视图，为刚刚添加的接口IMyATLClass添加方法。

6、现在来添加2个方法，分别用来计算两个数之和和弹出MFC对话框。

7、切换到【解决方案资源管理器】，可以看到Sum和PopupDialog的定义。

[cpp]  view plain copy

1. interface IMyATLClass : IDispatch{  
2.     [id(1)] HRESULT Sum([in] LONG para1, [in] LONG para2, [in] LONG* sum);  
3.     [id(2)] HRESULT PopupDialog([in] CHAR* text);  
4. };  

将参数[in] LONG* sum修改为[out] LONG* sum，表示这是一个需要输出的值。

8、打开MyATLClass.cpp，实现添加的两个方法。

[cpp]  view plain copy

1. STDMETHODIMP CMyATLClass::Sum(LONG para1, LONG para2, LONG* sum)  
2. {  
3.     AFX_MANAGE_STATE(AfxGetStaticModuleState());  
4.   
5.     // TODO: 在此添加实现代码  
6.     *sum = para1 + para2;  
7.   
8.     return S_OK;  
9. }  
10.   
11. STDMETHODIMP CMyATLClass::PopupDialog(CHAR* text)  
12. {  
13.     AFX_MANAGE_STATE(AfxGetStaticModuleState());  
14.   
15.     // TODO: 在此添加实现代码  
16.     AfxMessageBox((LPCTSTR)text);  
17.   
18.     return S_OK;  
19. }  

9、生成该工程，得到MyATL.dll并在注册表中注册。

二、测试ATL组件

1、在上面的工程中添加测试项目。

2、添加用于测试的MFC工程TestATL。

3、运行MFC应用程序向导，为简单起见，选择对话框工程，其余默认，点击完成。

4、将生成的对话框中【确定】、【取消】按钮修改如下。

5、双击上面的按钮，在系统生成的函数里删除掉代码CDialogEx::OnOK();如下。

[cpp]  view plain copy

1. void CTestATLDlg::OnBnClickedOk()  
2. {  
3.     // TODO: 在此添加控件通知处理程序代码  
4.   
5. }  
6.   
7. void CTestATLDlg::OnBnClickedCancel()  
8. {  
9.     // TODO: 在此添加控件通知处理程序代码  
10.   
11. }  

6、在TestATL工程中引入由MyATL工程中生成的“MyATL_i.h”、“MyATL_i.c”（这个文件主要用来查看CLSID_MyATLClass和IID_IMyATLClass的值），并在TestATLDlg.cpp中添加MyATL_i.h的引用。

[cpp]  view plain copy

1. #include "..\MyATL\MyATL_i.h"  

7、生成TestATL工程，会出现如下错误。

[cpp]  view plain copy

1. 1>d:\projects\test\myatl\myatl\myatl_i.c : fatal error C1853: “Debug\TestATL.pch”预编译头文件来自编译器的早期版本，或者预编译头为 C++ 而在 C 中使用它(或相反)  

解决方法是右键“MyATL_i.c”->属性->C/C++->预编译头，将“使用（/Yu）”修改为“不使用预编译头”。

再次生成TestATL就不会报错了。

8、实现Sum按钮的响应方法。

[cpp]  view plain copy

1. void CTestATLDlg::OnBnClickedOk()  
2. {  
3.     // TODO: 在此添加控件通知处理程序代码  
4.     HRESULT hr = S_OK;  
5.     hr = CoInitialize(NULL);  
6.   
7.     ITypeLib* pTypeLib = NULL;  
8.     hr = ::LoadTypeLib(L"..\\Debug\\MyATL.dll", &pTypeLib); //加载并注册类型库  
9.     if (FAILED(hr))  
10.     {  
11.         return;  
12.     }  
13.   
14.     int nTypeInfoCount = pTypeLib->GetTypeInfoCount();  
15.     if (nTypeInfoCount <= 0) //返回类型库中的类型说明的数量  
16.     {  
17.         return;  
18.     }  
19.   
20.     ITypeInfo* pTypeInfo = NULL;  
21.     TYPEATTR* pTypeAttr = NULL;  
22.   
23.     //！！！此处一定要注意导出类在.idl文件中的顺序！！！  
24.     hr = pTypeLib->GetTypeInfo(2, &pTypeInfo);  
25.     hr = pTypeInfo->GetTypeAttr(&pTypeAttr);  
26.     CLSID clsid = pTypeAttr->guid;  
27.   
28.     hr = pTypeLib->GetTypeInfo(3, &pTypeInfo);  
29.     hr = pTypeInfo->GetTypeAttr(&pTypeAttr);  
30.     IID iid = pTypeAttr->guid;  
31.   
32.     IMyATLClass* pMyATLClass = NULL;  
33.     hr = CoCreateInstance(clsid, NULL, CLSCTX_INPROC_SERVER, iid, (void **)&pMyATLClass);  
34.     hr = CoCreateInstance(CLSID_MyATLClass, NULL, CLSCTX_INPROC_SERVER, IID_IMyATLClass, (void **)&pMyATLClass);  
35.   
36.     int sum = 0;  
37.     pMyATLClass->Sum(2, 3, (LONG*)&sum);  
38.   
39.     pTypeInfo->ReleaseTypeAttr(pTypeAttr);  
40.     pTypeInfo->Release();  
41.     CoUninitialize();  
42. }  

9、将TestATL设置为启动项，在CoCreateInstance设置断点跟踪调试。启动应用后，点击Sum按钮，进入断点，在监视窗口看到clsid、iid是和CLSID_MyATLClass、IID_IMyATLClass一一对应的，这就说明在调用pTypeLib->GetTypeInfo的时候，其参数值index是正确的。

10、注释掉含有CLSID_MyATLClass那一行对CoCreateInstance的调用，添加对Sum的测试代码，调试运行在监视窗口可以看到运算结果。

11、添加对Popup Dialog的测试，过程略，结果如下。

[cpp]  view plain copy

1. pMyATLClass->PopupDialog("test ATL");  

考虑到编码问题，将MyATLClass.cpp中对PopupDialog的实现修改为：

[cpp]  view plain copy

1. STDMETHODIMP CMyATLClass::PopupDialog(CHAR* text)  
2. {  
3.     AFX_MANAGE_STATE(AfxGetStaticModuleState());  
4.   
5.     // TODO: 在此添加实现代码  
6.     CString str(text);  
7.     AfxMessageBox((LPCTSTR)str);  
8.   
9.     return S_OK;  
10. }  

重新生成MyATL，并启动TestATL测试如下。

12、再看pTypeLib->GetTypeInfo的调用。

程序中的调用是:

[cpp]  view plain copy

1. hr = pTypeLib->GetTypeInfo(2, &pTypeInfo);  
2. hr = pTypeInfo->GetTypeAttr(&pTypeAttr);  
3. CLSID clsid = pTypeAttr->guid;  
4.   
5. hr = pTypeLib->GetTypeInfo(3, &pTypeInfo);  
6. hr = pTypeInfo->GetTypeAttr(&pTypeAttr);  
7. IID iid = pTypeAttr->guid;  

注意到其中index的值分别是2、3，表示第3、4个值。另外，

[cpp]  view plain copy

1. int nTypeInfoCount = pTypeLib->GetTypeInfoCount();  

中nTypeInfoCount的值为4，这下就可以知道pTypeLib中前2个TypeInfo并不是所期望的，而第3、4个才是我们需要的，为什么会这样？

再次找到MyATL工程中的MyATL.idl文件，找到library MyATLLib的定义，

[cpp]  view plain copy

1. library MyATLLib  
2. {  
3.     importlib("stdole2.tlb");  
4.     [  
5.         uuid(59E6B9BA-489E-417A-BCE9-2AFFE61F57D1)        
6.     ]  
7.     coclass CompReg  
8.     {  
9.         [default] interface IComponentRegistrar;  
10.     };  
11.     [  
12.         uuid(03677350-0273-42BA-8F16-C7701493C1DC)        
13.     ]  
14.     coclass MyATLClass  
15.     {  
16.         [default] interface IMyATLClass;  
17.     };  
18. };  

可以看到首先定义的是CompReg这个类，它使得生成的dll完成了在注册表中的注册，并且它的两部分也正是pTypeLib->GetTypeInfo的前两部分，因此GetTypeInfo的index就变成了2和3。

下面修改CompReg和MyATLClass类定义的顺序，

[cpp]  view plain copy

1. library MyATLLib  
2. {  
3.     importlib("stdole2.tlb");  
4.     [  
5.         uuid(03677350-0273-42BA-8F16-C7701493C1DC)        
6.     ]  
7.     coclass MyATLClass  
8.     {  
9.         [default] interface IMyATLClass;  
10.     };  
11.     [  
12.         uuid(59E6B9BA-489E-417A-BCE9-2AFFE61F57D1)        
13.     ]  
14.     coclass CompReg  
15.     {  
16.         [default] interface IComponentRegistrar;  
17.     };  
18. };  

在调用pTypeLib->GetTypeInfo的时候，将参数设置为0、1，这时候也会成功运行。

最后，我们知道了在library MyATLLib中类定义的顺序决定了GetTypeInfo中index参数的值，注意不到这个问题，如果在接口自动化中随意写index参数的值，就会一直找不到方向，白白浪费时间。