ATL入门：利用ATL编写简单的COM组件

序论

 

      第一步：运行ATL COM Wizard

         运行Visual C++ 并创建一个新的工程，选择“ATL COM AppWizard”，项目名称为”Simple_ATL”。设置好项目的保存路径，单击“OK”，你将看到弹出的一个对话框，如下所示：

           我们将创建一个Server DLL， 故在“Server Type”项中选择“Dynamic Link Library(DLL)”，下面的三个“Check Box”在该工程中不考虑，保持默认值，单击“Finish”，ATL COM AppWizard将为你创建相应的文件，在弹出的“New Project Information”窗口中显示了这些文件的信息，单击“OK”完成工程的创建。

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

       在Visual C++的左边的工程视图区（如果没有打开，按“ATL+0”），选中ClassView标签，你将看到”Simple_ATL classes”， 选中它并单击鼠标右键，将弹出如下的对话框：

 

 

默认选项“Simple Object”就是我们所要创建的对象，单击“Next”，呈现在你面前的将是“ATL Object Wizard Properties”窗口，在“Short Name”一栏，输入“First_ATL”，注意其它输入栏中的名字将自动填写。选择“Attributes”标签页，此处要进行一些设定。“Threading Model”设为“Apartment”，“Interface”属性设为“Dual”，而“Aggregation”选中“NO”，其余选项不考虑，保留默认值。单击OK，Wizard将为我们创建新的ATL Simple Object。

 

     第三步：添加方法（Method）

       此时，工程视图区中增加一个名为CFirst_ATL的组件类。添加方法非常简单，右击“IFirst_ATL”，选中“Add Method…”，如下图：

  

当选择了“Add Method…”之后，将弹出“Add Method to Interface”的窗口。在返回类型中，方法的默认返回类型为“HRESULT”。在绝大多数情况下，应该保留该类型。在Method Name一栏中，填入方法的名字“AddNumbers”。最后一个输入栏为方法的参数。我们的方法是一个简单的加法运算，需要输入两个数并返回一个计算结果，因此我们需要三个参数。最后一个参数可以用指针。在参数框中我们输入如下内容：

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

其中 [in] 表示输入， [out] 表示输出。单击 OK ，完成方法的添加。在“ ClassView ”中，展开视图，你将在“ IFirst_ATL ”接口下看到我们添加的方法和相应的参数。双击打开该方法的实现，并添加相应的代码，如下：

 

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

  

第四步：编译

       按F7编译，VC++将完成DLL的编译，并且在注册表中注册新的组件DLL，从而使得其它程序能够使用它。

第五步： 在其它VC程序中测试COM Server

      打开 VC ，创建一个新的“ Win32 Console Application ”工程，添加一个“ Test_ATL.cpp ”文件，文件中添加如下代码：

     

#include  " ..Simple_ATLSimple_ATL.h "
#include  < iostream.h >

//  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  =  
    { 0x15DF21E3 , 0x5563 , 0x4BF4 ,
    { 0x9D , 0x97 , 0x7C , 0x72 , 0xAF , 0x9A , 0x87 , 0xF3 }};

const  CLSID CLSID_First_ATL  =  
    { 0x582996DD , 0xAE11 , 0x41DF ,
    { 0xA2 , 0x0E , 0xE7 , 0xA7 , 0x8A , 0xF4 , 0x68 , 0x67 }};


int  main( void )
{
    HRESULT    hr;
    IFirst_ATL  * IFirstATL  =  NULL;
     // Initialize 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;
        }
    }

    CoUninitialize();

     return   0 ;
}

 

       代码比较简单，如有不清楚的，可以通过注释理解，这里不在详细说明。编译，运行结果如下：

 

       这篇指南介绍了如何利用ATL创建一个简单的COM服务器，并且该服务器能够在其它程序中被调用。本文不打算深入介绍COM或者IDL语言的细节，相反，它向刚刚接触Visual C++的编程人员展示了利用ATL编写一个“Simple”COM是多么的easy，从而激起他们更多的学习热情。