使用ATL編寫一個簡單的COM服務器
本文的對象是COM編程初學者，其目的旨在描述如何用ATL創建COM服務器，以及如何在VC或VB編寫的客戶端應用程序中調用COM服務器。為了不給初學者增加負擔，本文不打算深入討論COM和IDL的細節，而是展示用ATL創建簡單的COM對象所需要的步驟。希望通過這篇文章能刺激你學習COM編程的欲望。
第一步：運行ATL COM向導
你要做的第一件事情是啟動VS2008創建一個新的工程。選擇“File->New Project”。彈出創建工程對話框，選擇"Visual C++->ATL->ATL Project"，在下面輸入工程名稱和路徑,注意這個向導創建的工程并沒有包含任何初始的COM對象，在完成這個向導之后，要從“ClassView”中用“New ATL Object”命令來指定你想要增加到這個工程中的對象類型。然后單擊"OK"按鈕。
第一部分單選按鈕選項是要創建的服務器類型“Server Type”。因為我們要創建一個進程內服務器（Server DLL），所以應該選擇的類型是動態鏈接庫“Dynamic Link Library——DLL”，注意所有進程內服務器都是DLL。下面是三個復選框不用去管它，它和我們創建的這個工程沒關系。單擊“Finish”按鈕。
第二步：創建新的ATL對象
為你的ATL項目（容器）添加供外部使用的Class (ATL Simple Object)。選項頁 “ C++”的“Short name”輸入欄中輸入你的Class名稱，其它輸入框會自動更新。
“Threading model”選“Apartment”;“Interface”選“Dual”;“Aggregation”選“No”;“Support”選“Connection points”和“I Object With Site(IE objects support)”。
在“Short Name”文本編輯框中輸入“First_ATL”。注意向導會自動填寫其余的文本編輯框。單擊“Attributes”標簽。其中有幾組單選按鈕選項和幾個復選框。第一組單選按鈕是線程模型“Threading Model”，我們取缺省值“Apartment Model”。第二組單選按鈕是接口“Interface”，單擊“Dual”，也就是雙接口。最后，第三組單選按鈕是聚合“Aggregation”，因為我們不想涉及接口的聚合，所以在此選擇“No”。至于底下的三個復選框，我們不用管它，單擊OK按鈕讓向導創建新的“ATL Simple Object”
第三步：添加方法
如果你單擊工作間的“ClassView”標簽，你會注意到向導在里面添加了一些內容。添加一個方法很容易，選中“IFirst_ATL”后單擊右鍵并選擇“Add Method”。
單擊“Add Method”后，你會看到“Add Method to Interface”對話框。
在“Return Type”編輯框中（已成灰色）這個方法的返回值已經缺省為 “HRESULT”。大多數情況下都應該是這個值類型。下一個編輯框是方法名“Method Name”，輸入方法名“AddNumbers”。最后一個編輯框是要你輸入希望使用的參數“Parameters”。由于我們打算將兩個數字相加，然后返回相加結果，所以要使用三個參數。最后一個參數是一個指針。現在你不用去關心繁雜的接口定義語言IDL，只要在這個參數編輯框中輸入如下內容：
[in] long Num1, [in] long Num2, [out] long *ReturnVal
它的意思是聲明兩個long類型輸入[in]參數和一個指針返回值[out]（剛開始可能會不習慣這樣怪怪的寫法，但等你閱讀了一兩本關于COM的書之后，會慢慢接收它的）。單擊OK按鈕。展開所有“ClassView”的節點“+”號。從這個視圖可以清楚地了解Simple_ATL各個類之間的層次關系。雙擊最上面“IFirst_ATL”（接口）節點下的“AddNumbers”（方法）節點，右邊屏幕將會顯示這個方法的實現代碼。添加如下的代碼：
1 STDMETHODIMP CFirst_ATL::AddNumbers(long Num1, long Num2, long *ReturnVal)
2 {
3 // TODO: Add your implementation code here
4 *ReturnVal = Num1 + Num2;
5
6 return S_OK;
7 }
第四步：編譯這個DLL
不管你想不相信，到目前為止，我們用ATL所創建的COM服務器已經完全能運行！當然，還需要編譯它才行。按下“F7”功能鍵，幾秒鐘之后，VC++便會完成編譯并注冊你所創建的DLL服務器。這樣其它的應用程序就可以使用這個COM服務器了。試一試吧！
第五步：用VC測試這個服務器
保存并關閉Simple_ATL工程，然后創建一個新的Win32 控制臺應用程序。選擇“Win32 Console Application”并取名為“Test_ATL”。單擊OK按鈕并接受對話框中的缺省設置（空的工程）。單擊“Finish”按鈕，然后再按OK按鈕。這樣就創建好了一個空的工程。按下“Control+N”鍵向工程中添加一個文件。從彈出的窗口中選擇“C++ Source File”并為它取名為“Test_ATL.cpp”。按下OK按鈕。這樣工程中就有了一個空的.CPP文件。我們要在這個文件中添加一些測試COM服務器的代碼：
// 將頭文件的目錄指到Simple_ATL工程所在的目錄
1 #include "stdafx.h"
2 #include "..\..\Simple_ATL\Simple_ATL\Simple_ATL_i.h"
3 #include "..\..\Simple_ATL\Simple_ATL\Simple_ATL_i.c"
4 #include <iostream>
5 using namespace std;
6 // 從Simple_ATL 工程所在目錄的Simple_ATL_i.c 文件中拷貝以下內容
7 // 注意: 你也可以不拷貝這些東西，而是把文件Simple_ATL_i.c包含進來。
8 // 我之所以將它拷進來，是想更清楚地展示這些敞亮來自什么地方一擊它們的代碼
9 // const IID IID_IFirst_ATL =
10 // {0x5AC2B2B7,0xBA06,0x4A4E,0x8D,0xED,0x78,0xDD,0x95,0x73,0x25,0x3B};
11 //
12 // const CLSID CLSID_First_ATL =
13 // {0x862DFA11,0x863B,0x4115,0xB7,0x39,0xB6,0x18,0x0E,0xBC,0x6B,0x66};
14
15 void main(void)
16 {
17 // 聲明HRESULT和Simple_ATL接口指針
18 HRESULT hr;
19 IFirst_ATL *IFirstATL = NULL;
20
21 // 初始化COM
22 hr = CoInitialize(0);
23
24 // 使用SUCCEEDED 宏并檢查我們是否能得到一個接口指針
25 if(SUCCEEDED(hr))
26 {
27 hr = CoCreateInstance( CLSID_First_ATL, NULL, CLSCTX_INPROC_SERVER,
28 IID_IFirst_ATL, (void**) &IFirstATL);
29
30 // 如果成功，則調用AddNumbers方法，否則顯示相應的出錯信息
31 if(SUCCEEDED(hr))
32 {
33 long ReturnValue;
34
35 IFirstATL->AddNumbers(5, 7, &ReturnValue);
36 cout << "The answer for 5 + 7 is: " << ReturnValue << endl;
37 IFirstATL->Release();
38 }
39 else
40 {
41 cout << "CoCreateInstance Failed." << endl;
42 }
43 }
44 // 釋放COM
45 CoUninitialize();
46 }
第七步：編譯并運行測試程序
按下“F5”功能鍵，編譯測試程序，然后按“Control+F5”功能組合鍵運行測試程序。在DOS窗口中，你應該能看到輸出的結果。
本文轉自：
http://andylin02.iteye.com/blog/453079。
posted on 2012-06-07 13:56
王海光 閱讀(1560)
評論(0) 編輯 收藏 引用 所屬分類:
ATL