初学者入门：一个COM/ATL简单项目 - VC编程

初学者入门：一个COM/ATL简单项目 - VC编程 [ http://www.99inf.net/SoftwareDev/VC/55014.htm ] ... 初学者入门：一个COM/ATL简单项目 作者：佚名文章来源： 不详 点击数： <script language="javascript" src="/SoftwareDev/GetHits.asp?ArticleID=55014" ></script> 更新时间：2007-9-12

<script language="javascript" src="/AD/200707/4.js" ></script>

译注：本文应用是VC6.0，对于其他版本向导可能与本文介绍的不同。

正在装载数据……

原文地址：http://www.codeproject.com/atl/com_atl.asp

Beginner's Tutorial: COM/ATL Simple Project

作者： C. Lung.

简介

本 教程 的目的在于，给读者一个关于使用ATL创建一个COM服务的方法的初步印象，并且让读者在使用VC++或者VB 编程 的时候，学会调用这个服务。本 教程 仅仅是为了VC++程序员中的初学者设计，因此笔者不打算深入介绍COM的细节，也不打算增加您学习IDL之类的负担。笔者希望展示的是使用ATL创建一个“简单”COM“对象方法简单易用，并且希望因此能让初学者对此感兴趣而深入学习。

第一步 ：运行 ATL COM 向导

启动VC++之后的第一步是创建一个新项目。选择“ ATL COM AppWizard ”。为本项目命名为“ Simple_ATL ”。设置本项目的保存路径，并点击OK。这是您将看到几个选项。第一个选择是“ 服务器 类型”。我们这里打算建立一个Server DLL（ 服务器 DLL），因此选择服务类型为“Dynamic Link Library（动态链接库）”。下面还有三个选项，不过与我们本次的项目无关，无视。点击结束按钮，保存本项目。这时屏幕上会显示一个“ New Project Information新项目信息 ”的窗口，这个窗口描述了刚才创建的项目内容。点击OK表示接受。

第二步：创建一个新的ATL对象

确保打开VC++ IDE中的Workspace（工作区）视图。如果没打开，您可以点击视图菜单，然后选择“Workspace ”。Workspace显示出来的内容中有三个选项卡，点击“ClassView（类视图）”选项卡，您将看到 "Simple_ATL Classes"。鼠标右键点击这个东东，然后选择 "New ATL Object（新建ATL对象）"。您将看到如下窗口：

默认选择 (Simple Object)就是我们需要的。点击“下一步”，您将看到 "ATL Object Wizard Properties（ "ATL Object Wizard 属性 ）"窗口。在“Short Name”中输入 "First_ATL"，您将看到向导会自动为您填写其他的输入栏。点击上端的 "Attributes（属性）"选项卡，将显示下列选项。第一个是 Threading Model（线程模式），我们保持默认的 Apartment Model就好。对于 "Interface（接口）"，选择“Dual”。最后，是我们不关心的 "Aggregation（集合）"，点击“No”选项。我们不需要关心底下的三个选项。点击OK确定就可以了。

第三步：添加一个方法

如果您现在在工作区点击“类视图”选项卡，您将看到向导已经在这里添加了一堆东西。我们要做的第一件事就是添加一个方法。我们可以通过右键点击“IFirst_ATL”然后选择”Add Method“轻松添加。

您点击“Add Method”之后，将看到“添加方法至界面”的窗口。在返回值类型下面，您可以看到默认的方法返回类型为“HRESULT”。大多数情况下，您不需要理会这个选项。下一个文字框允许我们输入方法名。我们在这里输入“ AddNumbers ”。最后一个文字框要求我们输入实用的参数。如果我们想要两个数相加，并返回一个结果，我们需要三个参数。最后一个参数是一个指针。现在我们先不去看那些三百多页的IDL 教程 ，直接把下面的内容输入到参数框中。

[in] long Num1, [in] long Num2, [out] long *ReturnVal

I在这里，我们生命了两个long型的参数，这两个参数是[in]也就是输入值，而最后一个值是返回的[out]输出值。（第一次看到可能觉得有点搞笑，不过如果您读过关于COM的书，就能够接受这种东西了）点击确认按钮。点击“ClassView”选项卡并且打开视图中的所有加号。最上面的接口 ("IFirst_ATL")被打开后，您能看到我们的“ AddNumbers ”方法，以及我们给他的参数。双击这个东东，将带我们进入编码区，我们修改代码如下：

STDMETHODIMP CFirst_ATL::AddNumbers( long Num1,
long Num2, long *ReturnVal)
{
// TODO: Add your implementation code here
*ReturnVal = Num1 + Num2;

return S_OK;
}

第四步：编译DLL

你相信么，现在已经我们已经用ATL建立好一个可以执行的COM服务了！当然，还要编译一下。在VC++的环境中按F7就可以了。编译器会“吱嘎吱嘎”一会儿——计算机在注册你的DLL，以便让其他程序可以使用。接下来，我们试一下。

第五步：用VB测试COM服务

首先我们用VB来试验一下COM服务。（如果你没有VB，也可以跳过这章，直接用VC测试）启动VB并选择 "Standard EXE（标准EXE）"作为你的项目。在对话框中放一个命令按钮。现在我们要配置COM服务了。点击“项目“菜单，选择“配置”。下拉这个列表，找到 "Simple ATL 1.0 Type Library"。

点击确认按钮。现在双击命令按钮，进入VB代码编辑窗口，输入下列代码：

Private Sub Command1_Click()
Dim objTestATL As SIMPLE_ATLLib.First_ATL
Set objTestATL = New First_ATL

Dim lngReturnValue As Long

objTestATL.AddNumbers 5 , 7 , lngReturnValue

MsgBox "The value of 5 + 7 is: " & lngReturnValue

Set objTestATL = Nothing
End Sub

如果你是一个的VB程序员，那么理解这段代码很简单。我们声明了一个对象，它从COM服务调用了” AddNumbers “，然后显示结果。按”F5“来运行这个VB项目，点击按钮，你可以看到结果

Not too hard. Lets try this again, except with VC++.

第六步：用VC测试COM服务

保存并关闭以前的 Simple_ATL项目，并创建一个新项目。选择 "Win32 Console Application"，命名为 "Test_ATL"，点击确认并接受下一个窗口的默认值 ”An empty project（空项目）“。用CTRL+N创建一个新文件。选择 "C++ Source File（c++源代码文件）"并且命名为 "Test_ATL.cpp"。按确认键接受。这时会打开一个空文件，我们需要在这里填入一些代码来测试我们的COM服务。将下列代码填入到这个新的cpp文件中：

// You need to point this header file to the directory
// you placed the Simple_ATL project

#include "../Simple_ATL/Simple_ATL.h"
#include

// Copy the following from the Simple_ATL_i.c file
// from the Simple_ATL project directory
// NOTE: You can actually skip copying these if you want
// and just include the Simple_ATL_i.c file, I simply added
// it for clarity to show where these const variables are
// coming from and what they look like

const IID IID_IFirst_ATL =
{ 0xC8F6E230 , 0x2672 , 0x11D3 ,
{ 0xA8 , 0xA8 , 0x00 , 0x10 , 0x5A , 0xA9 , 0x43 , 0xDF }};

const CLSID CLSID_First_ATL =
{ 0x970599E0 , 0x2673 , 0x11D3 ,
{ 0xA8 , 0xA8 , 0x00 , 0x10 , 0x5A , 0xA9 , 0x43 , 0xDF }};

void main( void )
{
// Declare and HRESULT and a pointer to
// the Simple_ATL interface
HRESULT hr;
IFirst_ATL *IFirstATL = NULL;

// Now we will intilize COM
hr = CoInitialize( 0 );

// Use the SUCCEEDED macro and see if
// we can get a pointer
// to the interface
if (SUCCEEDED(hr))
{
hr = CoCreateInstance( CLSID_First_ATL, NULL,
CLSCTX_INPROC_SERVER,
IID_IFirst_ATL, ( void **) &IFirstATL);

// If we succeeded then call the AddNumbers
// method, if it failed
// then display an appropriate message to the user.
if (SUCCEEDED(hr))
{
long ReturnValue;

IFirstATL->AddNumbers( 5 , 7 , &ReturnValue);
cout << "The answer for 5 + 7 is: "
<< ReturnValue << endl;
IFirstATL->Release();
}
else
{
cout << "CoCreateInstance Failed." << endl;
}
}
// Uninitialize COM
CoUninitialize();
}

第七步：编译并运行程序

按“F5”可以编译程序，然后按CTRL+F5可以运行程序。这是您可以看到一个DOS窗口，显示这您需要的结果。

<script src="http://www.codeproject.com/script/togglePre.js" type="text/javascript" ></script>

C. Lung

Click here to view C. Lung's online profile.

本文来源：http://blog.csdn.net/mhoudg/archive/2007/08/25/1758491.aspx

...