本文提供一個完全用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組件的話,這些代碼只能是拋磚引玉,具體的實現可以在此基礎上往下做.