一、前言

　　上兩回中，咱們用 ATL 寫了第一個 COM 組件程序，這回中，主要介紹編譯、注冊和調用方法。示例程序你已經下載了嗎？如果還沒有下載，vc6.0 的用戶點這里，vc.net 的用戶點這里。


二、關于編譯

　　2-1 最小依賴
　　“最小依賴”，表示編譯器會把 ATL 中必須使用的一些函數靜態連接到目標程序中。這樣目標文件尺寸會稍大，但獨立性更強，安裝方便；反之系統執行的時候需要有 ATL.DLL 文件的支持。如何選擇設置為“最小依賴”呢？答案是：刪除預定義宏“_ATL_DLL”，操作方法見圖一、圖二。


圖一、在vc6.0中，設置方法


圖二、在 vc.net 2003中，設置方法

　　2-2 CRT庫
　　如果在 ATL 組件程序中調用了 CRT 的運行時刻庫函數，比如開平方 sqrt() ，那么編譯的時候可能會報錯“error LNK2001: unresolved external symbol _main”。怎么辦？刪除預定義宏“_ATL_MIN_CRT”！操作方法也見圖一、圖二。（vc.net 2003 中的這個項目屬性叫“在 ATL 中最小使用 CRT”）

　　2-3 MBCS/UNICODE
　　這個不多說了，在預定義宏中，分別使用 _MBCS 或 _UNICODE。

　　2-4 IDL 的編譯
　　COM 在設計初期，就定了一個目標：要能實現跨語言的調用。既然是跨語言的，那么組件的接口描述就必須在任何語言環境中都要能夠認識。怎么辦？用 .h 文件描述？------ C語言程序員笑了，真方便！BASIC 程序員哭了:-( 因此，微軟使用了一個新的文件格式---IDL文件（接口定義描述語言）。IDL 是一個文本文件，它的語言語法比較簡單，很象C。具體 IDL 文件的講解，見下一回《COM 組件設計與應用（八）之添加新接口》。IDL 經過編譯，生成二進制的等價類型庫文件 TLB 提供給其它語言來使用。圖三示意了 ATL COM 程序編譯的過程：


圖三、ATL 組件程序編譯過程

　　說明1：編譯后，類型庫以 TLB 文件形式單獨存在，同時也保存在目標文件的資源中。因此，我們將來在 #import 引入類型庫的時候，既可以指定 TLB 文件，也可以指定目標文件；
　　說明2：我們作為 C/C++ 的程序員，還算是比較幸福的。因為 IDL 編譯后，特意為我們提供了 C 語言形式的接口文件。
　　說明3：IDL 編譯后生成代理/存根源程序，有：dlldata.c、xxx_p.c、xxxps.def、xxxps.mak，我們可以用 NMAKE.EXE 再次編譯來產生真正的代理/存根DLL目標文件(注1)。


三、關于注冊

　　情況1：當我們使用 ATL 編寫組件程序，注冊不用我們來負責。編譯成功后，IDE 會幫我們自動注冊；
　　情況2：當我們使用 MFC 編寫組件程序，由于編譯器不知道你寫的是否是 COM 組件，所以它不會幫我們自動注冊。這個時候，我們可以執行菜單“Tools\Register Control”來注冊。
　　情況3：當我們寫一個具有 COM 功能的 EXE 程序時，注冊的方法就是運行一次這個程序；
　　情況4：當我們需要使用第三方提供的組件程序時，可以命令行運行“regsvr32.exe 文件名”來注冊。順便說一句，反注冊的方法是“regsvr32.exe /u 文件名”；
　　情況5：當我們需要在程序中（比如安裝程序）需要執行注冊，那么：

typedef HRESULT (WINAPI * FREG)();
TCHAR szWorkPath[ MAX_PATH ];

::GetCurrentDirectory( sizeof(szWorkPath), szWorkPath );	// 保存當前進程的工作目錄
::SetCurrentDirectory( 組件目錄 );	// 切換到組件的目錄

HMODULE hDLL = ::LoadLibrary( 組件文件名 );	// 動態裝載組件
if(hDLL)
{
	FREG lpfunc = (FREG)::GetProcAddress( hDLL, _T("DllRegisterServer") );	// 取得注冊函數指針
	// 如果是反注冊，可以取得"DllUnregisterServer"函數指針
	if ( lpfunc )	lpfunc();	// 執行注冊。這里為了簡單，沒有判斷返回值
	::FreeLibrary(hDLL);
}

::SetCurrentDirectory(szWorkPath);	// 切換回原先的進程工作目錄

　　上面的示例，在多數情況下可以簡化掉切換工作目錄的代碼部分。但是，如果這個組件在裝載的時候，它需要同時加載一些必須依賴的DLL時，有可能由于它自身程序的 BUG 導致無法正確定位。咳......還是讓我們自己寫的程序，來彌補它的錯誤吧......誰讓咱們是好人呢 ，誰讓咱們的水平比他高呢，誰讓咱們在 vckbase 上是個“榜眼”呢......


四、關于組件調用

　　總的來說，調用組件程序大概有如下方法：
　

#include 方法	IDL編譯后，為方便C/C++程序員的使用，會產生xxx.h和xxx_i.c文件。我們真幸福，直接#include后就可以使用了
#import 方法	比較通用的方法，vc 會幫我們產生包裝類，讓我們的調用更方便
加載類型庫包裝類 方法	如果組件提供了 IDispatch 接口，用這個方法調用組件是最簡單的啦。不過還沒講IDispatch，只能看以后的文章啦
加載ActiveX包裝類 方法	ActiveX 還沒介紹呢，以后再說啦

　　下載示例程序后，請逐項瀏覽使用方法：

示例	方法	簡要說明
1	#include	完全用最基本的 API 方式調用組件，使大家熟悉調用原理
2	#include	大部分使用 API 方式，使用 CComBSTR 簡化對字符串的使用
3	#include	展示智能指針 CComPtr<> 的使用方法
4	#include	展示智能指針 CComPtr<> 和 CComQIPtr<> 混合的使用方法
5	#include	展示智能指針 CComQIPtr<> 的使用方法
6	#include	展示智能指針的釋放方法
7	#import	vc 包裝的智能指針 IxxxPtr、_bstr_t、_variant_t 的使用方法和異常處理
8	#import	import 后的命名空間的使用方法

　　示例程序中都寫有注釋，請讀者仔細閱讀并同時參考 MSDN 的函數說明。這里，我給大家介紹一下“智能指針”：
　　對于操作原始的接口指針是比較麻煩的，需要我們自己控制引用記數、API 調用、異常處理。于是 ATL 提供了2個智能指針的模板包裝類，CComPtr<> 和 CComQIPtr<>，這兩個類都在 <atlbase.h> 中聲明。CComQIPtr<> 包含了 CComPtr<>的所有功能，因此我們可以完全用 CComQIPtr<> 來使用智能接口指針，唯一要說明的一點就是：CComQIPtr<> 由于使用了運算符的重載功能，它會自動幫我們調用QueryInterface()函數，因此 CComQIPtr<> 唯一的缺點就是不能定義 IUnknown * 指針。

　　  // 智能指針 smart pointer，按照匈牙利命名法，一般以 sp 開頭來表示變量類型
　　  CComPtr < IUnknown > spUnk;	// 正確
　　  // 假設 IFun 是一個接口類型
　　  CComPtr < IFun > spFun;	// 正確
　　  CComQIPtr < IFun > spFun;	// 正確
　　  CComQIPtr < IFun, &IID_IFun > spFun;	// 正確
　　  CComQIPtr < IUnknown > spUnk;	// 錯誤！CComQIPtr不能定義IUnknown指針

給智能指針賦值的方法：

　　  CComQIPtr < IFun > spFun;	// 調用構造函數，還沒有賦值，被包裝的內部接口指針為 NULL
　　  
　　  CComQIPtr < IFun > spFun( pOtherInterface );	// 調用構造函數，內部接口指針賦值為
　　  // 通過 pOtherInterface 這個普通接口指針調用QueryInterface()得到的IFun接口指針
　　  
　　  CComQIPtr < IFun > spFun( spOtherInterface ); // 調用構造函數，內部接口指針賦值為
　　  // 通過 spOtherInterface 這個只能接口指針調用QueryInterface()得到的IFun接口指針
　　  
　　  CComQIPtr < IFun > spFun ( pUnknown );	// 調用構造函數，由IUnknown的QueryInterface()得到IFun接口指針
　　  
　　  CComQIPtr < IFun > spFun = pOtherInterface;	// = 運算符重載，含義和上面一樣
　　  spFun = spOtherInterface;	// 同上
　　  spFun = pUnknown;	// 同上
　　  
　　  pUnknown->QueryInterface( IID_IFun, &sp );	// 也可以通過QueryInterface賦值
　　  
　　  // 智能指針賦值后，可以用條件語句判斷是否合法有效
　　  if ( spFun ){}		// 如果指針有效
　　  if ( NULL != spFun ){}	// 如果指針有效
　　  
　　  if ( !spFun ){}		// 如果指針無效
　　  if ( NULL == spFun ){}	// 如果指針無效

智能指針調用函數的方法：

　　  spFun.CoCreateInstance(...);	// 等價與 API 函數::CoCreateInstance(...)
　　  spFun.QueryInterface(...);	// 等價與 API 函數::QueryInterface()
　　  
　　  spFun->Add(...);	// 調用內部接口指針的接口函數

　　  // 調用內部接口指針的QueryInterface()函數，其實效果和 spFun.QueryInterface(...) 一樣
　　  spFun->QueryInterface(...);	
　　  
　　  spFun.Release();	// 釋放內部的接口指針，同時內部指針賦值為 NULL
　　  spFun->Release();	// 錯！！！一定不要這么使用。
　　  // 因為這個調用并不把內部指針清空，那么析構的時候會被再次釋放（釋放了兩次）

咳......不說了，不說了，大家多看書，多看MSND，多看示例程序吧。 寫累了:-(

五、小結

　　敬請關注《COM 組件設計與應用(八)》------如何增加 ATL 組件中的第二個接口

---

注1：編譯代理/存根，vc6.0 中稍微麻煩，我們在后面介紹“進程外組件”和“遠程組件”的時候再介紹。在 vc.net 2003 下則比較簡單，因為代理/存根作為單獨的一個工程項目會自動加到我們的解決方案中了。