使用ATL編寫(xiě)一個(gè)簡(jiǎn)單的COM服務(wù)器
本文的對(duì)象是COM編程初學(xué)者，其目的旨在描述如何用ATL創(chuàng)建COM服務(wù)器，以及如何在VC或VB編寫(xiě)的客戶(hù)端應(yīng)用程序中調(diào)用COM服務(wù)器。為了不給初學(xué)者增加負(fù)擔(dān)，本文不打算深入討論COM和IDL的細(xì)節(jié)，而是展示用ATL創(chuàng)建簡(jiǎn)單的COM對(duì)象所需要的步驟。希望通過(guò)這篇文章能刺激你學(xué)習(xí)COM編程的欲望。
第一步：運(yùn)行ATL COM向?qū)?br /> 你要做的第一件事情是啟動(dòng)VS2008創(chuàng)建一個(gè)新的工程。選擇“File->New Project”。彈出創(chuàng)建工程對(duì)話(huà)框，選擇"Visual C++->ATL->ATL Project"，在下面輸入工程名稱(chēng)和路徑,注意這個(gè)向?qū)?chuàng)建的工程并沒(méi)有包含任何初始的COM對(duì)象，在完成這個(gè)向?qū)е螅獜?#8220;ClassView”中用“New ATL Object”命令來(lái)指定你想要增加到這個(gè)工程中的對(duì)象類(lèi)型。然后單擊"OK"按鈕。
第一部分單選按鈕選項(xiàng)是要?jiǎng)?chuàng)建的服務(wù)器類(lèi)型“Server Type”。因?yàn)槲覀円獎(jiǎng)?chuàng)建一個(gè)進(jìn)程內(nèi)服務(wù)器（Server DLL），所以應(yīng)該選擇的類(lèi)型是動(dòng)態(tài)鏈接庫(kù)“Dynamic Link Library——DLL”，注意所有進(jìn)程內(nèi)服務(wù)器都是DLL。下面是三個(gè)復(fù)選框不用去管它，它和我們創(chuàng)建的這個(gè)工程沒(méi)關(guān)系。單擊“Finish”按鈕。
第二步：創(chuàng)建新的ATL對(duì)象
為你的ATL項(xiàng)目（容器）添加供外部使用的Class (ATL Simple Object)。選項(xiàng)頁(yè) “ C++”的“Short name”輸入欄中輸入你的Class名稱(chēng)，其它輸入框會(huì)自動(dòng)更新。
“Threading model”選“Apartment”;“Interface”選“Dual”;“Aggregation”選“No”;“Support”選“Connection points”和“I Object With Site(IE objects support)”。
在“Short Name”文本編輯框中輸入“First_ATL”。注意向?qū)?huì)自動(dòng)填寫(xiě)其余的文本編輯框。單擊“Attributes”標(biāo)簽。其中有幾組單選按鈕選項(xiàng)和幾個(gè)復(fù)選框。第一組單選按鈕是線程模型“Threading Model”，我們?nèi)∪笔≈?#8220;Apartment Model”。第二組單選按鈕是接口“Interface”，單擊“Dual”，也就是雙接口。最后，第三組單選按鈕是聚合“Aggregation”，因?yàn)槲覀儾幌肷婕敖涌诘木酆希栽诖诉x擇“No”。至于底下的三個(gè)復(fù)選框，我們不用管它，單擊OK按鈕讓向?qū)?chuàng)建新的“ATL Simple Object”
第三步：添加方法
如果你單擊工作間的“ClassView”標(biāo)簽，你會(huì)注意到向?qū)г诶锩嫣砑恿艘恍﹥?nèi)容。添加一個(gè)方法很容易，選中“IFirst_ATL”后單擊右鍵并選擇“Add Method”。
單擊“Add Method”后，你會(huì)看到“Add Method to Interface”對(duì)話(huà)框。
在“Return Type”編輯框中（已成灰色）這個(gè)方法的返回值已經(jīng)缺省為 “HRESULT”。大多數(shù)情況下都應(yīng)該是這個(gè)值類(lèi)型。下一個(gè)編輯框是方法名“Method Name”，輸入方法名“AddNumbers”。最后一個(gè)編輯框是要你輸入希望使用的參數(shù)“Parameters”。由于我們打算將兩個(gè)數(shù)字相加，然后返回相加結(jié)果，所以要使用三個(gè)參數(shù)。最后一個(gè)參數(shù)是一個(gè)指針。現(xiàn)在你不用去關(guān)心繁雜的接口定義語(yǔ)言IDL，只要在這個(gè)參數(shù)編輯框中輸入如下內(nèi)容：
[in] long Num1, [in] long Num2, [out] long *ReturnVal
它的意思是聲明兩個(gè)long類(lèi)型輸入[in]參數(shù)和一個(gè)指針?lè)祷刂礫out]（剛開(kāi)始可能會(huì)不習(xí)慣這樣怪怪的寫(xiě)法，但等你閱讀了一兩本關(guān)于COM的書(shū)之后，會(huì)慢慢接收它的）。單擊OK按鈕。展開(kāi)所有“ClassView”的節(jié)點(diǎn)“+”號(hào)。從這個(gè)視圖可以清楚地了解Simple_ATL各個(gè)類(lèi)之間的層次關(guān)系。雙擊最上面“IFirst_ATL”（接口）節(jié)點(diǎn)下的“AddNumbers”（方法）節(jié)點(diǎn)，右邊屏幕將會(huì)顯示這個(gè)方法的實(shí)現(xiàn)代碼。添加如下的代碼：
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 }
第四步：編譯這個(gè)DLL
不管你想不相信，到目前為止，我們用ATL所創(chuàng)建的COM服務(wù)器已經(jīng)完全能運(yùn)行！當(dāng)然，還需要編譯它才行。按下“F7”功能鍵，幾秒鐘之后，VC++便會(huì)完成編譯并注冊(cè)你所創(chuàng)建的DLL服務(wù)器。這樣其它的應(yīng)用程序就可以使用這個(gè)COM服務(wù)器了。試一試吧！
第五步：用VC測(cè)試這個(gè)服務(wù)器
保存并關(guān)閉Simple_ATL工程，然后創(chuàng)建一個(gè)新的Win32 控制臺(tái)應(yīng)用程序。選擇“Win32 Console Application”并取名為“Test_ATL”。單擊OK按鈕并接受對(duì)話(huà)框中的缺省設(shè)置（空的工程）。單擊“Finish”按鈕，然后再按OK按鈕。這樣就創(chuàng)建好了一個(gè)空的工程。按下“Control+N”鍵向工程中添加一個(gè)文件。從彈出的窗口中選擇“C++ Source File”并為它取名為“Test_ATL.cpp”。按下OK按鈕。這樣工程中就有了一個(gè)空的.CPP文件。我們要在這個(gè)文件中添加一些測(cè)試COM服務(wù)器的代碼：
// 將頭文件的目錄指到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 文件中拷貝以下內(nèi)容
7 // 注意: 你也可以不拷貝這些東西，而是把文件Simple_ATL_i.c包含進(jìn)來(lái)。
8 // 我之所以將它拷進(jìn)來(lái)，是想更清楚地展示這些敞亮來(lái)自什么地方一擊它們的代碼
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 宏并檢查我們是否能得到一個(gè)接口指針
25 if(SUCCEEDED(hr))
26 {
27 hr = CoCreateInstance( CLSID_First_ATL, NULL, CLSCTX_INPROC_SERVER,
28 IID_IFirst_ATL, (void**) &IFirstATL);
29
30 // 如果成功，則調(diào)用AddNumbers方法，否則顯示相應(yīng)的出錯(cuò)信息
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 }
第七步：編譯并運(yùn)行測(cè)試程序
按下“F5”功能鍵，編譯測(cè)試程序，然后按“Control+F5”功能組合鍵運(yùn)行測(cè)試程序。在DOS窗口中，你應(yīng)該能看到輸出的結(jié)果。
本文轉(zhuǎn)自：
http://andylin02.iteye.com/blog/453079。
posted on 2012-06-07 13:56
王海光 閱讀(1552)
評(píng)論(0) 編輯 收藏 引用 所屬分類(lèi):
ATL