| 下載下傳例子代碼 |
| 本文的對象是COM程式設計初學者，其目的旨在描述如何用ATL建立COM伺服器，以及如何在VC或VB編寫的用戶端應用程式中調用COM伺服器。為了不給初 學者增加負擔，本文不打算深入讨論COM和IDL的細節，而是展示用ATL建立簡單的COM對象所需要的步驟。希望通過這篇文章能刺激你學習COM程式設計的 欲望。 第一步：運作ATL COM向導（參見圖一） 你要做的第一件事情是啟動VC建立一個新的工程。選擇“ATL COM AppWizard”。注意這個向導建立的工程并沒有包含任何初始的COM對象，在完成這個向導之後，要從“ClassView”中用“New ATL Object”指令來指定你想要增加到這個工程中的對象類型。 在“Project name”編輯框中為工程取個名字：“Simple_ATL”。在“Location”編輯框中指定工程的存放位置，如“E:\samples\Simple_ATL”，然後單擊OK按鈕。 |
 |
| （圖一） |
| 你會看到一個選擇螢幕（圖二）。 |
 |
| （圖二） |
| 第一部分單選按鈕選項是要建立的伺服器類型 “Server Type”。因為我們要建立一個程序内伺服器（Server DLL），是以應該選擇的類型是動态連結庫“Dynamic Link Library——DLL”，注意所有程序内伺服器都是DLL。下面是三個複選框不用去管它，它和我們建立的這個工程沒關系。單擊“Finish”按鈕。 向導将自動産生相應的檔案。然後出現“New Project Information”視窗告訴你向導将要建立一些什麼檔案（圖三）。确認後單擊OK按鈕。 |
| |
| （圖三） |
| 第二步：建立新的ATL對象 确定在VC的IDE環境中見到“Workspace View”。也就是工作間視圖。你也可以進入“View”菜單，然後選擇“Workspace”。這個視圖中由三個标簽，單擊“ClassView”标 簽。你會看到其中的“Simple_ATL Classes”。選中後單擊右鍵并從彈出菜單中選擇“New ATL Object”。你會見到如下視窗：（圖四） |
| |
| （圖四） |
| 我們就用預設選擇（Simple Object），也就是簡單對象。單擊“Next”按鈕進入“ATL Object Wizard Properties”，也就是ATL對象向導的屬性對話框（圖五）。 |
| |
| （圖五） |
| 在“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”（方法）節點，右邊螢幕将會顯示這個方法的實作代碼。添加如下的代碼： 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伺服器已經完全能運作！當然，還需要編譯它才行。按下“F7”功能鍵，幾秒鐘之後，VC++便會完成編譯并注冊你所建立的DLL伺服器。這樣其它的應用程式就可以使用這個COM伺服器了。試一試吧！ 第五步：用VB測試這個伺服器 為了用VB來測試COM伺服器，首先你必須安裝VB的開發環境。（如果你沒有安裝VB或不想用VB測試，可以跳過這一步到下一步：用VC++測試COM服 務器。）首先啟動VB，選擇建立标準EXE“Standard EXE”工程。在對話框中放一個按鈕。然後我們要引用COM伺服器。單擊“Project”菜單并選擇“References”。然後下翻頁直到可以看見 “Simple ATL 1.0 Type Library”（如圖八），然後選中它。 |
| |
| （圖八） |
| 單擊OK按鈕。現在輕按兩下前面在對話框中建立的指令按鈕，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工程，單擊對話框中的指令按鈕，你會看到輸出的結果。（如圖九） |
| |
| （圖九） |
| 下面再讓我們用VC++測試這個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工程所在的目錄 #include "..\Simple_ATL\Simple_ATL.h" #include // 從Simple_ATL 工程所在目錄的Simple_ATL_i.c 檔案中拷貝以下内容 // 注意: 你也可以不拷貝這些東西，而是把檔案Simple_ATL_i.c包含進來。 // 我之是以将它拷進來，是想更清楚地展示這些敞亮來自什麼地方一擊它們的代碼 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) { // 聲明HRESULT和Simple_ATL接口指針 HRESULT hr; IFirst_ATL *IFirstATL = NULL; // 初始化COM hr = CoInitialize(0); // 使用SUCCEEDED 宏并檢查我們是否能得到一個接口指針 if(SUCCEEDED(hr)) { hr = CoCreateInstance( CLSID_First_ATL, NULL, CLSCTX_INPROC_SERVER, IID_IFirst_ATL, (void**) &IFirstATL); // 如果成功，則調用AddNumbers方法，否則顯示相應的出錯資訊 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; } } // 釋放COM CoUninitialize(); } 第七步：編譯并運作測試程式 按下“F5”功能鍵，編譯測試程式，然後按“Control+F5”功能組合鍵運作測試程式。在DOS視窗中，你應該能看到輸出的結果。 |