用C++語言編寫COM組件

作者：佚名 2011-07-20 16:23:14

本文提供一個完全用C++實現的進程內（DLL）COM服務器，不要ATL或MFC提供任何支持。用這種方式編寫COM對象可以讓你深入地洞察到COM處理進程內服務器的方法以及COM是如何創建類工廠的。利用本文提供的這個簡單框架你可以實現很基本的COM組件，如外殼擴展（Shell Extensions）等。

本文提供一個完全用C++實現的進程內（DLL）COM服務器，不要ATL或MFC提供任何支持。用這種方式編寫COM對象可以讓你深入地洞察到COM處理進程內服務器的方法以及COM是如何創建類工廠的。利用本文提供的這個簡單框架你可以實現很基本的COM組件，如外殼擴展（Shell Extensions）等。

以下是用本文所說的方式編寫自己的COM對象要經過的步驟：

第一步：寫一個頭文件，這個頭文件包含以下內容：

1、包含文件comdef.h：#include <comdef.h>。

2、定義COM服務器的GUID。

_declspec(selectany) GUID CLSID_Mine = { 0xdc186800,  
0x657f,  
0x11d4,   
{0xb0, 0xb5, 0x0, 0x50, 0xba, 0xbf, 0xc9, 0x4}  
};

3、給出接口的IID以及這個接口要實現的方法定義。到時客戶端會用到這個接口的IID和接口的方法。

interface __declspec(uuid("F614FB00-6702-11d4-B0B7-0050BABFC904")) ImyInterface : public IUnknown  
{  
STDMETHOD(Square)(long *pVal)PURE;  
STDMETHOD(Cube)(long *pVal)PURE;  
};

客戶端使用此接口：

HRESULT hr;  
ImyInterface *pmine=(0);  
hr = CoCreateInstance(CLSID_Mine, // COM 服務器的CLSID   
NULL, //不支持聚合  
CLSCTX_INPROC_SERVER, // 是個DLL   
__uuidof(ImyInterface), // 接口的IID  
(void**)&pmine   
);

還有一種方法可以從注冊表中獲得COM對象的CLSID，就是調用CLSIDFromProgId()函數，不過必須把組件的ProgId傳遞給這個函數。

第二步：必須為所定義的接口提供實現，本文用的方法是創建一個從接口繼承的新類：

// 這個類實現單接口ImyInterface ...  
//   
//   
class CmyInterface : public CComBase<> ,   
public InterfaceImpl<ImyInterface>   
{  
public:  
CmyInterface();  
virtual ~CmyInterface();  
// 我們必須要為QueryInterface 編寫代碼  
STDMETHOD(QueryInterface)(REFIID riid,LPVOID *ppv);  
// ImyInterface 接口方法  
STDMETHOD(Square)(long *pVal);  
STDMETHOD(Cube)(long *pVal);  
};

模版類InterfaceImpl<>提供接口引用計數的實現。在此我們可以用多接口繼承，那樣就能在一個COM組件中實現多個接口。

第三步：在完成這個對象之前，我們還要編寫Queryinterface和兩個接口方法：

STDMETHODIMP CmyInterface::QueryInterface(REFIID riid,LPVOID *ppv)  
{  
*ppv = NULL;  
if(IsEqualIID(riid,IID_IUnknown) || IsEqualIID(riid,__uuidof(ImyInterface)))  
{  
// 因為我們從ImyInterface繼承，所以要進行強制類型轉換  
*ppv = (ImyInterface *) this;  
 
_AddRef(); // 這個方法從某個基類繼承而來  
return S_OK;  
}  
return E_NOINTERFACE;  
}  
 
STDMETHODIMP CmyInterface::Square(long *pVal)  
{  
long value = *pVal;  
*pVal = value * value;  
return S_OK;  
}  
 
STDMETHODIMP CmyInterface::Cube(long *pVal)  
{  
long value = *pVal;  
*pVal = value * value * value;  
return S_OK;  
}

注意這里使用了__uuidof(ImyInterface)來獲取接口的IID，這是因為我們已經在第一步中將這個接口關聯到了某個uuid。

最后一步：COM 組件的DLLs必須輸出一個叫DllGetClassObject的函數。由這個函數為CmyInterface創建類工廠并返回一個對它的引用。然后我們調用CoCreateInstance為進程內COM創建類工廠，接著調用DllGetClassObject。這個類工廠有一個方法是CreateInstance，由這個方法創建對象并返回對它的引用。

STDAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID *ppvOut)  
{  
*ppvOut = NULL;  
if (IsEqualIID(rclsid, CLSID_Mine))  
{  
// 為CmyInterface類聲明類工廠  
CClassFactory<CmyInterface>   
*pcf = new CClassFactory<CmyInterface>;   
return pcf->QueryInterface(riid,ppvOut);  
}  
return CLASS_E_CLASSNOTAVAILABLE;  
}

在此我們要檢查所請求的CLSID是不是CLSID_Mine，如果不是則返回一個錯誤代碼。

你可能會問在哪里創建實際的CmyInterface類對象，實際上這是由CClassFactory<CmyInterface>的模板實例來處理的。以下是CClassFatory的實現：

// CSingleCreator 用于單實例類工廠，這個類為多個CreateObject請求返回相同的對象指針..   
template<class comObj>  
class CSingleCreator  
{  
protected:  
CSingleCreator():m_pObj(0) {};  
comObj *CreateObject()  
{  
if(!m_pObj)  
{  
m_pObj = new comObj;  
}  
return m_pObj;  
}  
comObj * m_pObj;  
};  
// CMultiCreator 用于常用類工廠，這個類為每一個CreateObject請求返回新的對象指針..  
template<class comObj>  
class CMultiCreator  
{  
protected:  
CMultiCreator():m_pObj(0) {};  
comObj *CreateObject()  
{  
return new comObj;  
}  
comObj * m_pObj;  
};  
//ClassFactory類實現  
// MultiCreator是缺省的類工廠創建者  
//這個類實現了接口IclasFactory......  
 
class CClassFactory : public CComBase<>,  
public InterfaceImpl<IClassFactory>,  
public creatorClass   
{  
public:  
CClassFactory() {};  
virtual ~CClassFactory() {};  
 
STDMETHOD(QueryInterface)(REFIID riid,LPVOID *ppv)  
{  
*ppv = NULL;  
if(IsEqualIID(riid,IID_IUnknown) || IsEqualIID(riid,IID_IClassFactory))  
{  
*ppv = (IClassFactory *) this;  
_AddRef();   
return S_OK;  
}  
return E_NOINTERFACE;  
}  
 
STDMETHODIMP CreateInstance(LPUNKNOWN pUnkOuter, REFIID riid, LPVOID *ppvObj)  
{  
*ppvObj = NULL;  
if (pUnkOuter)  
return CLASS_E_NOAGGREGATION;  
m_pObj = CreateObject(); // m_pObj 在creatorClass中定義  
if (!m_pObj)  
return E_OUTOFMEMORY;  
HRESULT hr = m_pObj->QueryInterface(riid, ppvObj);  
if(hr != S_OK)  
{  
delete m_pObj;  
}  
return hr;  
}  
STDMETHODIMP LockServer(BOOL) { return S_OK; } // 未實現  
};

COM調用CreateInstance創建請求的對象，參數riid指的是所請求的接口IID，如果這個對象支持這個接口，則增加它的引用計數并返回對自身的引用。

關于代碼：本文所提出的方法是如何用純粹的C++編寫COM組件的一個大概念。很多方面的細節都省略了。從本文的文字和代碼中可以看出用純C++編寫COM組件需要做些什么工作，如果你要用這種方法編寫COM組件的話，這些代碼只能是拋磚引玉，具體的實現可以在此基礎上往下做.

責任編輯：于鐵來源：互聯網

C++