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

一、创建ATL工程

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

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

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

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

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

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

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

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

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

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

STDMETHODIMP CMyATLClass::Sum(LONG para1, LONG para2, LONG* sum)
{
	AFX_MANAGE_STATE(AfxGetStaticModuleState());

	// TODO: 在此添加实现代码
	*sum = para1 + para2;

	return S_OK;
}

STDMETHODIMP CMyATLClass::PopupDialog(CHAR* text)
{
	AFX_MANAGE_STATE(AfxGetStaticModuleState());

	// TODO: 在此添加实现代码
	AfxMessageBox((LPCTSTR)text);

	return S_OK;
}

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

二、测试ATL组件

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

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

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

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

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

void CTestATLDlg::OnBnClickedOk()
{
	// TODO: 在此添加控件通知处理程序代码

}

void CTestATLDlg::OnBnClickedCancel()
{
	// TODO: 在此添加控件通知处理程序代码

}

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

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

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

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按钮的响应方法。

void CTestATLDlg::OnBnClickedOk()
{
	// TODO: 在此添加控件通知处理程序代码
	HRESULT hr = S_OK;
	hr = CoInitialize(NULL);

	ITypeLib* pTypeLib = NULL;
	hr = ::LoadTypeLib(L"..\\Debug\\MyATL.dll", &pTypeLib); //加载并注册类型库
	if (FAILED(hr))
	{
		return;
	}

	int nTypeInfoCount = pTypeLib->GetTypeInfoCount();
	if (nTypeInfoCount <= 0) //返回类型库中的类型说明的数量
	{
		return;
	}

	ITypeInfo* pTypeInfo = NULL;
	TYPEATTR* pTypeAttr = NULL;

	//！！！此处一定要注意导出类在.idl文件中的顺序！！！
	hr = pTypeLib->GetTypeInfo(2, &pTypeInfo);
	hr = pTypeInfo->GetTypeAttr(&pTypeAttr);
	CLSID clsid = pTypeAttr->guid;

	hr = pTypeLib->GetTypeInfo(3, &pTypeInfo);
	hr = pTypeInfo->GetTypeAttr(&pTypeAttr);
	IID iid = pTypeAttr->guid;

	IMyATLClass* pMyATLClass = NULL;
	hr = CoCreateInstance(clsid, NULL, CLSCTX_INPROC_SERVER, iid, (void **)&pMyATLClass);
	hr = CoCreateInstance(CLSID_MyATLClass, NULL, CLSCTX_INPROC_SERVER, IID_IMyATLClass, (void **)&pMyATLClass);

	int sum = 0;
	pMyATLClass->Sum(2, 3, (LONG*)&sum);

	pTypeInfo->ReleaseTypeAttr(pTypeAttr);
	pTypeInfo->Release();
	CoUninitialize();
}

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

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

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

pMyATLClass->PopupDialog("test ATL");

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

STDMETHODIMP CMyATLClass::PopupDialog(CHAR* text)
{
	AFX_MANAGE_STATE(AfxGetStaticModuleState());

	// TODO: 在此添加实现代码
	CString str(text);
	AfxMessageBox((LPCTSTR)str);

	return S_OK;
}

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

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

程序中的调用是:

	hr = pTypeLib->GetTypeInfo(2, &pTypeInfo);
	hr = pTypeInfo->GetTypeAttr(&pTypeAttr);
	CLSID clsid = pTypeAttr->guid;

	hr = pTypeLib->GetTypeInfo(3, &pTypeInfo);
	hr = pTypeInfo->GetTypeAttr(&pTypeAttr);
	IID iid = pTypeAttr->guid;

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

int nTypeInfoCount = pTypeLib->GetTypeInfoCount();

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

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

library MyATLLib
{
	importlib("stdole2.tlb");
	[
		uuid(59E6B9BA-489E-417A-BCE9-2AFFE61F57D1)		
	]
	coclass CompReg
	{
		[default] interface IComponentRegistrar;
	};
	[
		uuid(03677350-0273-42BA-8F16-C7701493C1DC)		
	]
	coclass MyATLClass
	{
		[default] interface IMyATLClass;
	};
};

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

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

library MyATLLib
{
	importlib("stdole2.tlb");
	[
		uuid(03677350-0273-42BA-8F16-C7701493C1DC)		
	]
	coclass MyATLClass
	{
		[default] interface IMyATLClass;
	};
	[
		uuid(59E6B9BA-489E-417A-BCE9-2AFFE61F57D1)		
	]
	coclass CompReg
	{
		[default] interface IComponentRegistrar;
	};
};

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

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

附：

源码地址：网盘代码 | CSDN代码

参考出处：VS2010创建ATL工程及使用C++测试COM组件