ATL是什麼

ATL,Active TEmplate Library活動模板庫,是一種微軟程序庫,支持利用C++語言編寫ASP代碼以及其它ActiveX程序。通過活動模板庫,可以建立COM組件,然後 通過ASP頁面中的腳本對COM對象進行調用。這種COM組件可以包含屬性頁、對話框等等控件。 

ATL簡介 
   一. 什麼是ATL 
  自從1993年Microsoft首次公佈了COM技術以後,Windows平臺上的開發模式發生了巨大的變化,以COM爲基礎的一系列軟件組件化技 術將Windows編程帶入了組件化時代。廣大的開發人員在爲COM帶來的軟件組件化趨勢歡欣鼓舞的同時,對於COM開發技術的難度和煩瑣的細節也感到極 其的不便。COM編程一度被視爲一種高不可攀的技術,令人望而卻步。開發人員希望能夠有一種方便快捷的COM開發工具,提高開發效率,更好地利用這項技 術。
 
  針對這種情況,Microsoft公司在推出COM SDK以後,爲簡化COM編程,提高開發效率,採取了許多方案,特別是在MFC(Microsoft Foundation Class)中加入了對COM和OLE的支持。但是隨着Internet的發展,分佈式的組件技術要求COM組件能夠在網絡上傳輸,而又儘量節約寶貴的網 絡帶寬資源。採用MFC開發的COM組件由於種種限制不能很好地滿足這種需求,因此Microsoft在1995年又推出了一種全新的COM開發工具 ATL。
  ATL是ActiveX Template Library 的縮寫,它是一套C++模板庫。使用ATL能夠快速地開發出高效、簡潔的代碼(Effective and Slim code),同時對COM組件的開發提供最大限度的代碼自動生成以及可視化支持。爲了方便使用,從Microsoft Visual C++ 5.0版本開始,Microsoft把ATL集成到Visual C++開發環境中。1998年9月推出的Visual Studio 6.0 集成了ATL 3.0版本。目前,ATL已經成爲Microsoft標準開發工具中的一個重要成員,日益受到C++開發人員的重視。
  ATL究竟給開發人員帶來了什麼樣的益處呢?這還要先從ATL產生以前的COM開發方式說起。
  在ATL產生以前,開發COM組件的方法主要有兩種:一是使用COM SDK直接開發COM組件,另一種方式是通過MFC提供的COM支持來實現。
 
  直接使用COM SDK開發COM組件是最基本也是最靈活的方式。通過使用Microsoft提供的開發包,我們可以直接編寫COM程序。但是,這種開發方式的難度和工作 量都很大,一方面,要求開發者對於COM的技術原理具有比較深入的瞭解(雖然對技術本身的深刻理解對使用任何一種工具都是非常有益的,但對於COM這樣一 整套複雜的技術而言,在短時間內完全掌握是很難的),另一方面,直接使用COM SDK要求開發人員自己去實現COM應用的每一個細節,完成大量的重複性工作。這樣做的結果是,不僅降低了工作效率,同時也使開發人員不得不把許多精力投 入到與應用需求本身無關的技術細節中。雖然這種開發方式對於某些特殊的應用很有必要,但這種編程方式並不符合組件化程序設計方法所倡導的可重用性,因此, 直接採用COM SDK不是一種理想的開發方式。
  使用MFC提供的COM支持開發COM應用可以說在使用COM SDK基礎上提高了自動化程度,縮短了開發時間。MFC採用面向對象的方式將COM的基本功能封裝在若干MFC的C++類中,開發者通過繼承這些類得到 COM支持功能。爲了使派生類方便地獲得COM對象的各種特性,MFC中有許多預定義宏,這些宏的功能主要是實現COM接口的定義和對象的註冊等通常在 COM對象中要用到的功能。開發者可以使用這些宏來定製COM對象的特性。
  另外,在MFC中還提供對Automation 和 ActiveX Control的支持,對於這兩個方面,Visual C++也提供了相應的AppWizard和ClassWizard支持,這種可視化的工具更加方便了COM應用的開發。
  MFC對COM和OLE 的支持確實比手工編寫COM程序有了很大的進步。但是MFC對COM的支持是不夠完善和徹底的,例如對COM接口定義的IDL語言,MFC並沒有任何支 持,此外對於近些年來COM和ActiveX技術的新發展MFC也沒有提供靈活的支持。這是由MFC設計的基本出發點決定的。MFC被設計成對 Windows平臺編程開發的面向對象的封裝,自然要涉及Windows編程的方方面面,COM作爲Windows平臺編程開發的一個部分也得到MFC的 支持,但是MFC對COM的支持是以其全局目標爲出發點的,因此對COM 的支持必然要服從其全局目標。從這個方面而言,MFC對COM的支持不能很好的滿足開發者的要求。
  隨着Internet技術的發展,Microsoft將ActiveX技術作爲其網絡戰略的一個重要組成部分大力推廣,然而使用MFC開發的 ActiveX Control,代碼冗餘量大(所謂的“肥代碼 Fat Code”),而且必須要依賴於MFC的運行時刻庫才能正確地運行。雖然MFC的運行時刻庫只有部分功能與COM有關,但是由於MFC的繼承實現的本 質,ActiveX Control必須揹負運行時刻庫這個沉重的包袱。如果採用靜態連接MFC運行時刻庫的方式,這將使ActiveX Control代碼過於龐大,在網絡上傳輸時將佔據寶貴的網絡帶寬資源;如果採用動態連接MFC運行時刻庫的方式,這將要求瀏覽器一方必須具備MFC的運 行時刻庫支持。總之MFC對COM技術的支持在網絡應用的環境下也顯得很不靈活。
  解決上述COM開發方法中的問題正是ATL的基本目標。
  首先ATL的基本目標就是使COM應用開發儘可能地自動化,這個基本目標就決定了ATL只面向COM開發提供支持。目標的明確使ATL對COM技術的 支持達到淋漓盡致的地步。對COM開發的任何一個環節和過程,ATL都提供支持,並將與COM開發相關的衆多工具集成到一個統一的編程環境中。對於 COM/ActiveX的各種應用,ATL也都提供了完善的Wizard支持。所有這些都極大地方便了開發者的使用,使開發者能夠把注意力集中在與應用本 身相關的邏輯上。
  其次,ATL因其採用了特定的基本實現技術,擺脫了大量冗餘代碼,使用ATL開發出來的COM應用的代碼簡練高效,即所謂的“Slim Code”。ATL在實現上儘可能採用優化技術,甚至在其內部提供了所有C/C++開發的程序所必須具有的C啓動代碼的替代部分。同時ATL產生的代碼在 運行時不需要依賴於類似MFC程序所需要的龐大的代碼模塊,包含在最終模塊中的功能是用戶認爲最基本和最必須的。這些措施使採用ATL開發的COM組件 (包括ActiveX Control)可以在網絡環境下實現應用的分佈式組件結構。
  第三,ATL的各個版本對Microsoft的基於COM的各種新的組件技術如MTS、ASP等都有很好的支持,ATL對新技術的反應速度大大快於 MFC。ATL已經成爲Microsoft支持COM應用開發的主要開發工具,因此COM技術方面的新進展在很短的時間內都會在ATL中得到反映。這使開 發者使用ATL進行COM編程可以得到直接使用COM SDK編程同樣的靈活性和強大的功能。
  本文的目的就是希望在有限的篇幅中能夠使讀者對ATL的使用和基本原理有一個初步的瞭解,爲廣大的COM開發人員更好地使用ATL開發起到拋磚引玉的作用。
  二. ATL基本技術
  雖然使用ATL開發COM 應用是一件非常簡單的事情,但是在ATL簡單易用的界面後面卻包含着複雜的技術。面對ATL生成的大量代碼,我們即使不去深入地瞭解這些代碼的含義也可以 開發出COM應用來,但是如果我們要充分地挖掘ATL的潛力,開發出更靈活、強大的COM應用,則必須對ATL使用的基本技術有所瞭解。研究ATL的實質 最好的教材就是由Visual C++提供的ATL源代碼。本文這一部分只是對ATL中用到的最基本的技術進行簡單的介紹。
  簡單地說來,ATL中所使用的基本技術包括以下幾個方面:
   COM技術 
 
   C++模板類技術(Template) 
   C++多繼承技術(Multi-Inheritance) 
  COM技術是理解ATL的基礎,使用ATL進行開發要對COM技術的基本概念有最低限度的瞭解。由於COM是一項非常複雜龐大的技術體系,限於本文的篇幅,這裏不再贅述。對於本文中提到的COM基本概念也不做過多的解釋,請讀者參閱有關的參考書籍。
  作爲ATL最核心的實現技術的模板是對標準C++語言的擴展,但是在大多數的C++編程環境中,人們很少使用它,這是因爲模板的功能雖然很強,但是它 內部機制比較複雜,需要比較多的C++知識和經驗才能靈活地使用它。在MFC中的CObjectArray等功能類就是由模板來定義的。完全通過模板來定 義程序的整體類結構,ATL是迄今爲止做得最爲成功的。
  所謂模板類簡單地說是對類的抽象。我們知道C++語言用類定義了構造對象(這裏指C++對象而不是COM對象)的方式,對象是類的實例,而模板類定義的是類的構造方式,使用模板類定義實例化的結果產生的是不同的類。因此可以說模板類是“類的類”。
  在C++語言中模板類的定義格式如下:
注意:<和>是左右尖括號,可能無法正常顯示。
template < class T>
class MyTemp
{
MyTemp<T>( ){ };
~MyTemp<T>( ) { };
int MyFunc( int a) ;
}
………….
Int MyTemp<T>::MyFunc( int a)
{

  首先使用C++的關鍵字“template”來聲明一個模板類的定義。在關鍵字後面是用尖括號括起來的類型參數。正是根據這個類型參數,編譯器才能在 編譯過程中將模板類的具體定義轉化爲一個實際的類的定義,即生成一個新的類。接下來的定義方式與普通的類定義十分相似,只是在類的函數定義中都要帶有類型 參數的說明。
  下面的程序段說明了模板類的用法:

typedef MyTemp<MyClass> myclassfromtemp;
myclassfromtemp m;
int a = m.Myfunc(10);  
  通常在使用模板類時爲了方便起見,使用一個關鍵字“typedef”爲新定義出來的類取一個名字。在上面的程序段中假設“MyClass”是一個由用 戶定義的類,通過將這個類的名字作爲類型參數傳遞給模板類,我們可以創建一個新的類,這個類的行爲將以模板類的定義爲基礎,例如它具有模板類定義的所有成 員函數,同時這個類又是對模板類行爲的一種修改,這種修改是通過用戶提供的類型參數來實現的。賦予模板類以不同的類型參數,則得到行爲框架相似但具體行爲 不同的一組類的集合。有了新的類的定義以後,我們可以象使用普通類一樣來創建一個類的實例,即一個新的對象,並且調用這個對象的成員函數。
  模板類是對標準C++語言的最新擴展,雖然它的功能很強大,但是要想使用好模板類需要相當多的關於語言和編程的經驗和知識,而且錯誤地使用模板類又會 對程序的結構和運行效率帶來大的副作用,因此一般的編程環境和編程書籍對模板類的使用都採取謹慎的態度。而ATL的核心就是由幾十個模板類構成的,通過研 究ATL的源代碼可以使我們對模板類的使用有比較深刻全面的認識。
  多繼承技術同模板一樣,是C++語言中極具爭議性的技術。使用多繼承技術可以使程序的設計和實現更加靈活,但是,由於多繼承的複雜性和自身概念上的一 些問題,使多繼承在各種面向對象的語言環境中得到的支持都非常有限。例如Small Talk根本就不允許多繼承,同樣MFC也不支持多繼承技術。
  多繼承最大的問題是所謂的“鑽石結構”。例如下面的代碼:

class A
{
.....
};
class B : public A

.. .
};

class C : public A
{
.....
};

class D : public C,B
{
........


  由於類D同時從類C和B繼承,因此在下面的語句中就會發生歧義:

D* pD = new D;
(A*)pD->Func(...);  
  由於類D通過類C和類B 分別繼承了類A,這裏的強制轉化就會發生歧義。
  ATL使用了C++最新規範中加入的兩個運算符號 static_cast、dynamic_cast代替簡單的強制轉化,從而消除多繼承帶來的歧義。使用這兩個運算符號,我們可以在對象運行過程中獲取對象的類型信息。上面的代碼可以採用下面的方式修改:

D* pD = new D;
static_cast<A*>(static_cast<B*>(pD))->Func(...); 
  爲什麼模板類和多繼承技術會成爲ATL主要的工具呢?原因在於,採用模板可以在編譯過程中快速的生成具有用戶定製功能的類,這對於COM這樣一個複雜 的技術體系在實現效率上得到了很大的提高。通過使用模板類,用戶可以把精力集中在自己開發的類的基本邏輯上,在完成了自己的類的設計以後,通過繼承不同的 類,生成不同的模板類,就可以快速地實現COM的功能,同時又避免了採用單繼承結構造成的大量功能冗餘。
  總之,正是由於在設計實現過程中採用了模板類和多繼承技術,才使ATL成爲一個小巧靈活的COM開發工具,能夠適應開發人員對COM應用開發的各種需要。

  三. ATL基本使用 
  這一部分將重點介紹ATL的基本使用過程。由於ATL已經被集成在Microsoft Visulal Studio的Visual C++開發環境中,因此要使用ATL必須先安裝Visual C++。在下面的討論中有關COM的基本知識請參閱有關的文檔,這裏不再詳細說明。給出的圖是在Microsoft Windows 98平臺下Visual Studio 6.0的使用示意圖。
  使用ATL開發一個COM應用基本可以分爲以下幾個步驟:
  創建一個新的ATL工程,並對工程的選項進行適當的配置。 
  向新創建的工程添加新的ATL類,並對該類進行一些初始配置工作。 
  根據COM應用的基本要求向新的ATL類加入新的接口定義,並實現相應的接口成員函數。 
  編譯連接工程,註冊COM應用。 
  下面將根據這些步驟依次介紹ATL的基本使用過程。
  1. 創建工程
  首先啓動Visual C++集成開發環境,選擇“File”菜單下的“New...”命令,在“New”對話框中選擇“Project”頁。
  選擇“ATL COM AppWizard”項,這是創建ATL工程的AppWizard嚮導入口。然後在“Project name”編輯框中輸入工程的名字,單擊“OK”按鈕,進入AppWizard對話框。
  在AppWizard對話框中主要的設置選項有:
  COM服務程序的類型:
   - 動態連接庫(Dynamic Linking Library) 最終產生一個動態連接庫(DLL)形式的COM服務程序;
   - 應用程序(Executable application)最終產生一個可執行程序類型(EXE)的COM服務程序;
   - NT服務(NT Service):產生一個以NT服務方式運行的COM服務程序。 
  允許嵌入Proxy/Stub代碼。由Microsoft提供的MIDL編譯IDL文件以後,將產生用於對象調度(Marshaling)的 Proxy/Stub的代碼。傳統地,這部分代碼與COM服務程序的代碼是分離的,但是由於新的COM標準支持多線程環境下的COM對象服務,因此在動態 連接庫的COM服務程序中也要有Proxy/Stub的支持。爲了支持在網絡上的傳輸,ATL允許用戶選擇將Proxy/Stub的代碼包括在生成的 DLL代碼中。這個選項在EXE和NT服務類型的COM應用條件下不可選。 
  允許支持MFC。由於ATL對除COM以外的基本的Windows編程方面的支持極爲有限,同時許多程序員對MFC又非常熟悉,因此在ATL的工程設 置中允許在ATL工程內部支持使用MFC,即可以使用MFC定義的類。這在一方面來看是非常方便的,特別是對於習慣於使用MFC的開發人員來說,能夠使用 MFC提供的各種功能強大的類的支持,而不必直接使用Windows SDK。從另一個方面來看,在ATL工程中使用MFC同時就喪失了ATL代碼輕量級的特點。 
  支持MTS。MTS是Microsoft Transaction Server的縮寫,它是Microsoft在COM技術方面的一個新的分支,這裏不作詳細說明。 
  完成上面的設置以後,可以選擇FINISH完成工程的設置,ATL將創建相應的工程。
  2. 加入ATL類
  完成工程的創建和設置以後,下一步就是向工程中加入一個新的ATL類。Visual Studio集成環境提供了嚮導工具“ATL Object Wizard”用於加入一個新的ATL類。操作過程並不複雜,只是一組對話框操作而已。
  首先通過集成環境的“Insert”菜單下的“New ATL Object…”命令進入“ATL Object Wizard”對話框。
  這個對話框即爲創建ATL對象的嚮導起始界面。對話框的左邊部分說明了待創建對象的基本類型,這裏主要有以下的幾種類型:
  對象(Object)基本的COM對象類型; 
  控制(Control)ActiveX Control類型的ATL對象; 
  其他(Miscellaneous)輔助功能,如對話框的生成等; 
  數據訪問(Data Access)數據訪問,支持MTS等。 
  右邊部分說明了每種類型的詳細內容,對於一般的COM服務程序,使用對象表中的簡單對象(Simple Object)就可以了。
  選定待創建對象的基本類型以後,單擊“Next>”按鈕進入下一步,進入對象屬性設置對話框,如圖4和圖5所示。
  對象屬性設置分爲兩個過程:先是對象名字標識的設定,然後是對對象的基本屬性進行設置。首先是對象的名字標識設置。
  在對象標識編輯框中輸入待創建對象的名字,ATL對象嚮導將同步地根據用戶輸入的對象標識設定該對象的C++標識和COM標識。對象的C++標識包括 對象的類名,cpp文件名和頭文件名。COM標識包括對象在類型庫中的CoClass段和實現的主接口的名字,同時還有在系統註冊表中的類型名以及 ProgID。
  對象名字標識設置完成以後,選擇對象屬性頁(Attribute)進入對象的屬性設置頁面。
  對象的屬性設置是ATL對象創建過程中最複雜的部分,包括以下幾個主要部分:
  對象的線程模型(Thread Model)
  對象的線程模型是COM對象在多線程環境下被訪問時對訪問方式的控制,缺省情況下在ATL中採用的是套間模型Apartment,由系統通過消息隊列方式提供併發控制。 
  對象的接口模型(Interface)
  COM對象的接口可以是雙接口(Dual Interface)。雙接口不同於普通接口(Custom Interface) 之處在於雙接口是從Automation基本接口IDispatch繼承的,而普通接口是從IUnknown接口直接繼承來的。缺省的接口模型是雙接口。 
  對象的聚合模型(Aggregate)
  COM規範不允許對象的實現繼承,但是可以通過聚合方式重用其它的COM對象。ATL對象屬性設置中的聚合模型可以指定待創建的COM對象是否支持聚合模型。缺省的選項是支持對象的聚合。 
  對象對錯誤處理的支持(Support ISupportErrorInfo)
  選取這個選項可以在對象的運行過程中支持錯誤處理。缺省情況下這個選項不被選中。 
  對象對連接點的支持(Support Connection Points)
  連接點是COM對象的事件機制。選中這個選項可以使待創建的COM對象具有發出事件的能力。缺省情況下該選項不被選中。 
  對象對自由線程調度的支持(Free Thread Marshaller, 簡稱FTM)
  對象的自由線程調度是對象在處於自由線程模型狀態下,爲了簡化對象的訪問過程而採用的一種優化策略。缺省情況下該選項不被選中。 
  對於上述的任何一個選項的詳細描述都涉及到COM技術一些核心的內容,並且都已超出本文的範圍,因此本文只對ATL給出的缺省選項加以說明,對這些內容感興趣的讀者可以參考Microsoft提供的文檔。
  完成了上面的設置以後,就可以按“OK”按鈕完成對象的創建過程。下一步就是向所生成的ATL類的接口中加入成員函數的定義,以及接口成員函數的實現過程。

  3. 加入接口定義,實現接口函數 
  加入了ATL類定義之後,我們可以打開Visual C++集成環境下項目管理器(Workspace)中的Class View來檢查生成的類定義的情況。我們可以看到一個新的類已經生成,同時,還生成了相應的接口定義。ATL Object Wizard爲我們生成了類定義的.h 和.cpp文件,此外還有用於接口定義的IDL文件。有了這些文件以後,我們就可以爲接口加入成員函數,完成類的定義。
  首先在Class View中選中相應的接口,顯示爲接口IATLTest,單擊鼠標右鍵打開菜單,如圖7。此彈出式菜單定義了爲接口加入屬性和方法的操作。選取其中的 “Add Method...”項,可以爲接口加入方法成員;選取“Add Property...”則可以爲接口加入新的屬性成員。
  加入屬性和方法的對話框可以參看圖8和圖9。如果我們要在接口中加入一個方法,則選取“Add Method...”菜單命令。假設方法名爲ABC,方法的返回類型爲COM規定的HRESULT類型。我們也可以定義非HRESULT返回類型的函數, 但是這需要手工修改接口定義的IDL文件。我們定義ABC方法的一個參數爲a,類型爲整數型。完成了方法的定義以後,單擊“OK”按鈕則把此方法加入到接 口中。
  屬性的加入過程是類似的。屬性加入對話框要求指定屬性的類型、名字以及屬性的訪問方式。在屬性和方法的編輯對話框中都有一個“Attributes”按鈕,在給出了一個屬性或方法的基本定義之後,單擊此按鈕,可以對屬性和方法的一些高級特性進行設置。
  方法成員加入以後,我們可以通過Class View來檢查ATL爲我們所做的工作。首先我們看到ATL在接口的定義中加入了該方法的定義;同時在對應的ATL類定義中,也加入了一個相應的方法的定 義;在類對應的.cpp文件中,加入了此方法的實現框架。此後,我們只要在這個函數框架中加入該方法的代碼邏輯,一個接口函數的定義和實現就基本完成了。 依照這種方式,我們可以完成整個COM對象的定義和實現。
  完成以上的步驟之後,我們就可以編譯連接應用了。
  4. 編譯連接應用、註冊COM服務程序
  對ATL工程的編譯連接過程包括下面的幾個步驟:
  使用MIDL編譯工程的IDL文件,形成接口定義的頭文件和用於調度(Marshalling)的代碼; 
  編譯工程的.cpp文件形成目標文件; 
  連接目標文件,形成應用模塊; 
  註冊COM服務程序。 
  關於工程編譯連接的其它部分同Visual C++中MFC工程的編譯連接過程相似,這裏只重點介紹一下COM服務程序的註冊過程。
  在ATL中,COM服務程序的註冊是在工程編譯連接的最後階段,由ATL輔助完成的。在手工的COM編程中,服務程序的註冊是比較麻煩的工作。在 ATL中,系統通過讀取在建立工程過程中形成的註冊腳本文件來完成註冊工作。註冊腳本(Register Script 簡稱RGS)是ATL提供的文本方式的註冊輔助文件。下面是註冊腳本文件的一個實例。
  HKCR - 表示註冊表中COM對象的註冊項,是HKEY_CLASS_ROOT的縮寫
{
AuthTest.ActiveXObject.1 = s 'ActiveXObject Class'
{
CLSID = s ''
} - 對象的ProgID
AuthTest.ActiveXObject = s 'ActiveXObject Class'
{
CLSID = s ''
} -對象的與版本無關的ProgID
NoRemove CLSID -對象CLSID註冊項
{
ForceRemove  = s 'ActiveXObject Class'
{
ProgID = s 'AuthTest.ActiveXObject.1'
VersionIndependentProgID = s 'AuthTest.ActiveXObject'
InprocServer32 = s '%MODULE% -服務器類型,表示DLL服務器
{
val ThreadingModel = s 'both' -線程模型,這裏是BOTH型
}
}
}
}
  RGS文件包含註冊COM服務程序的各項內容,通常我們不必修改此RGS文件,必要時我們也可以手工修改RGS文件來定製模塊的註冊過程。
  四. 應用ATL的一個例子
  上面介紹了使用ATL創建一個COM服務程序的基本過程。在介紹過程中,我們實際上已經生成了一個COM服務程序的基本框架,只是沒有填寫實際的內 容。在下面部分,我們實際開發一個十分簡單的COM服務程序,並且爲它編寫一段客戶代碼進行測試,使大家對使用ATL開發COM服務程序的過程有一個全面 整體的瞭解。
  我們要開發的服務程序的功能很簡單,它只實現一個接口,這個接口名字是ISimpleInterface,接口只有一個成員函數,叫做Welcome。這個函數的功能只是輸出一個“Hello World!”的字符串。
  按照上一部分介紹的創建COM服務程序的步驟,我們進行如下的操作:
  1 打開Visual C++集成開發環境;
  2 創建一個稱爲SimpleTest的ATL工程;
  3 在這個工程中插入新的對象,對象的名字是SimpleInterface;
  4 設置接口ISimpleInterface的有關屬性,使它成爲一個雙接口;
  5 在對象的接口ISimpleInterface中加入方法Welcome;
  6 打開ATL加入的Welcome方法的框架,可以看到如下的代碼段:

STDMETHODIMP CActiveXObject::get_TestProp(long *pVal)
{
AFX_MANAGE_STATE(AfxGetStaticModuleState())
// TODO: Add your implementation code here
return S_OK;
}  
  7 將程序框架中的註釋部分替換爲下面的代碼:
::MessageBox(NULL,_T(”Hello World!”),_T(”Welcome”), MB_OK);
Welcome方法被調用時將彈出一個消息框。
  8 編譯連接工程。
  上面的步驟完成以後,我們就有了一個簡單的COM服務程序,而且已經被註冊到當前系統中。
  下面我們要完成一個簡單的COM客戶程序。一個COM客戶程序簡單地說是使用COM組件對象的程序。客戶程序調用COM對象的基本流程是:
  創建COM對象的實例。這可以通過調用Windows系統的API函數CoCreateInstance來完成。 
  通過接口調用函數。 
  調用IUnknown::Release釋放COM對象實例 
  我們的客戶程序是使用MFC編寫的一個基於對話框的簡單應用程序。具體的過程如下:
  1 打開Visual C++集成開發環境;
  創建一個稱爲SimpleClient的基於對話框的MFC工程; 
  在對話框中加入一個按鈕,名字爲TEST; 
  在SimpleClient.cpp文件中加入如下的代碼: 
  (1) 在cpp文件 #include “simpleclientdlg.h”之後加入下面的代碼:
  #include “d:/simpletest/simpletest_i.h” // 根據需要修改頭文件的路徑
  加入的頭文件是在編譯COM服務程序過程中自動生成的,其中包含接口本身的定義、接口IID的定義和COM對象的CLSID的定義。包含該頭文件可以使客戶程序能夠使用COM服務程序。
  (2) 在按鈕TEST的消息控制函數中加入如下的代碼:
HRESULT hr; 
ISimpleInterface* pIntf = NULL;
hr = CoCreateInstance(CLSID_SimpleInterface, NULL, CLSCTX_SERVER , 
IID_ISimpleInterface, (void **)& pIntf);
if(SUCCEEDED(hr))
{
pIntf->Welcome();
pIntf->Release();
}  
  上面的代碼首先通過系統API CoCreateInstance創建COM對象,得到接口的指針,然後調用接口成員函數Welcome,最後通過IUnknown::Release()函數釋放COM對象實例。
  編譯連接客戶程序
  最後,我們可以測試客戶程序是否正常運行。啓動客戶程序,當單擊“TEST”按鈕時我們可以看到彈出一個消息框,這正是我們的COM服務程序提供的功能。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章