C++写一个COM组件

最新推荐文章于 2024-01-10 15:59:18 发布

一直在路上25

最新推荐文章于 2024-01-10 15:59:18 发布

阅读量1k

点赞数

分类专栏： C++算法

C++算法专栏收录该内容

56 篇文章

订阅专栏

本文提供一个完全用C++实现的进程内（DLL）COM服务器，不要ATL或MFC提供任何支持。用这种方式编写COM对象可以让你深入地洞察到COM处理进程内服务器的方法以及COM是如何创建类工厂的。利用本文提供的这个简单框架你可以实现很基本的COM组件，如外壳扩展（Shell Extensions）等。如果你在使用过程中发现了任何问题，请将它反馈vckbase@public.hk.hi.cn。

以下是用本文所说的方式编写自己的COM对象要经过的步骤：

第一步：写一个头文件，这个头文件包含以下内容：

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

2、定义COM服务器的GUID。

 
   1. 
   _declspec(selectany) GUID CLSID_Mine = { 0xdc186800, 
  
   2. 
   0x657f, 
  
   3. 
   0x11d4,  
  
   4. 
   {0xb0, 0xb5,  0x0,  0x50,  0xba,  0xbf,  0xc9,  0x4} 
  
   5. 
   };

3、给出接口的IID以及这个接口要实现的方法定义。到时客户端会用到这个接口的IID和接口的方法。

 
   01. 
   interface __declspec(uuid("F614FB00-6702-11d4-B0B7-0050BABFC904")) ImyInterface : public IUnknown 
  
   02. 
   { 
  
   03. 
   STDMETHOD(Square)(long *pVal)PURE; 
  
   04. 
   STDMETHOD(Cube)(long *pVal)PURE; 
  
   05. 
   }; 
  
   06. 
     
   07. 
   客户端使用此接口： 
  
   08. 
   HRESULT hr; 
  
   09. 
   ImyInterface *pmine=(0); 
  
   10. 
   hr = CoCreateInstance(CLSID_Mine,               // COM 服务器的CLSID  
  
   11. 
   NULL,         //不支持聚合 
  
   12. 
   CLSCTX_INPROC_SERVER,     // 是个DLL  
  
   13. 
   __uuidof(ImyInterface),   // 接口的IID 
  
   14. 
   (void**)&pmine         
  
   15. 
   );

还有一种方法可以从注册表中获得COM对象的CLSID，就是调用CLSIDFromProgId()函数，不过必须把组件的ProgId传递给这个函数。

第二步：必须为所定义的接口提供实现，本文用的方法是创建一个从接口继承的新类：

// 这个类实现单接口ImyInterface ...

 
   01. 
   class CmyInterface : public CComBase<> ,  
  
   02. 
   public InterfaceImpl  
  
   03. 
   { 
  
   04. 
   public: 
  
   05. 
   CmyInterface(); 
  
   06. 
   virtual ~CmyInterface(); 
  
   07. 
     
   08. 
   // 我们必须要为QueryInterface 编写代码 
  
   09. 
   STDMETHOD(QueryInterface)(REFIID riid,LPVOID *ppv); 
  
   10. 
     
   11. 
   // ImyInterface 接口方法 
  
   12. 
   STDMETHOD(Square)(long *pVal); 
  
   13. 
   STDMETHOD(Cube)(long *pVal); 
  
   14. 
     
   15. 
   };

模版类InterfaceImpl<>提供接口引用计数的实现。在此我们可以用多接口继承，那样就能在一个COM组件中实现多个接口。

第三步：在完成这个对象之前，我们还要编写Queryinterface和两个接口方法：

 
   01. 
   STDMETHODIMP CmyInterface::QueryInterface(REFIID riid,LPVOID *ppv) 
  
   02. 
   { 
  
   03. 
   *ppv = NULL; 
  
   04. 
   if(IsEqualIID(riid,IID_IUnknown) || IsEqualIID(riid,__uuidof(ImyInterface))) 
  
   05. 
   { 
  
   06. 
   // 因为我们从ImyInterface继承，所以要进行强制类型转换 
  
   07. 
   *ppv = (ImyInterface *) this;   
  
   08. 
     
   09. 
   _AddRef();    // 这个方法从某个基类继承而来 
  
   10. 
   return S_OK; 
  
   11. 
   } 
  
   12. 
   return E_NOINTERFACE; 
  
   13. 
   } 
  
   14. 
     
   15. 
   STDMETHODIMP CmyInterface::Square(long *pVal) 
  
   16. 
   { 
  
   17. 
   long value = *pVal; 
  
   18. 
   *pVal = value * value; 
  
   19. 
   return S_OK; 
  
   20. 
   } 
  
   21. 
     
   22. 
   STDMETHODIMP CmyInterface::Cube(long *pVal) 
  
   23. 
   { 
  
   24. 
   long value = *pVal; 
  
   25. 
   *pVal = value * value * value; 
  
   26. 
   return S_OK; 
  
   27. 
   }

注意这里使用了__uuidof(ImyInterface)来获取接口的IID，这是因为我们已经在第一步中将这个接口关联到了某个uuid。

最后一步：COM 组件的DLLs必须输出一个叫DllGetClassObject的函数。由这个函数为CmyInterface创建类工厂并返回一个对它的引用。然后我们调用CoCreateInstance为进程内COM创建类工厂，接着调用DllGetClassObject。这个类工厂有一个方法是CreateInstance，由这个方法创建对象并返回对它的引用。

 
   01. 
   STDAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID *ppvOut) 
  
   02. 
   { 
  
   03. 
   *ppvOut = NULL; 
  
   04. 
   if (IsEqualIID(rclsid, CLSID_Mine)) 
  
   05. 
   { 
  
   06. 
   // 为CmyInterface类声明类工厂 
  
   07. 
   CClassFactory  
  
   08. 
   *pcf = new CClassFactory;   
  
   09. 
   return pcf->QueryInterface(riid,ppvOut); 
  
   10. 
   } 
  
   11. 
   return CLASS_E_CLASSNOTAVAILABLE; 
  
   12. 
   }

在此我们要检查所请求的CLSID是不是CLSID_Mine，如果不是则返回一个错误代码。

你可能会问在哪里创建实际的CmyInterface类对象，实际上这是由CClassFactory的模板实例来处理的。以下是CClassFatory的实现：

// CSingleCreator 用于单实例类工厂，这个类为多个CreateObject请求返回相同的对象指针..

 
   01. 
   template 
  
   02. 
   class CSingleCreator 
  
   03. 
   { 
  
   04. 
   protected: 
  
   05. 
   CSingleCreator():m_pObj(0) {}; 
  
   06. 
     
   07. 
   comObj *CreateObject() 
  
   08. 
   { 
  
   09. 
   if(!m_pObj) 
  
   10. 
   { 
  
   11. 
   m_pObj = new comObj; 
  
   12. 
   } 
  
   13. 
   return m_pObj; 
  
   14. 
   } 
  
   15. 
   comObj * m_pObj; 
  
   16. 
   }; 
  
   17. 
     
   18. 
   // CMultiCreator 用于常用类工厂，这个类为每一个CreateObject请求返回新的对象指针.. 
  
   19. 
   template 
  
   20. 
   class CMultiCreator 
  
   21. 
   { 
  
   22. 
   protected: 
  
   23. 
   CMultiCreator():m_pObj(0) {}; 
  
   24. 
   comObj *CreateObject() 
  
   25. 
   { 
  
   26. 
   return new comObj; 
  
   27. 
   } 
  
   28. 
   comObj * m_pObj; 
  
   29. 
   }; 
  
   30. 
     
   31. 
     
   32. 
   //ClassFactory类实现 
  
   33. 
   // MultiCreator是缺省的类工厂创建者 
  
   34. 
   //这个类实现了接口IclasFactory...... 
  
   35. 
     
   36. 
   class CClassFactory  : public CComBase<>, 
  
   37. 
   public InterfaceImpl, 
  
   38. 
   public creatorClass  
  
   39. 
   { 
  
   40. 
   public: 
  
   41. 
   CClassFactory() {}; 
  
   42. 
   virtual ~CClassFactory() {}; 
  
   43. 
     
   44. 
   STDMETHOD(QueryInterface)(REFIID riid,LPVOID *ppv) 
  
   45. 
   { 
  
   46. 
   *ppv = NULL; 
  
   47. 
   if(IsEqualIID(riid,IID_IUnknown) || IsEqualIID(riid,IID_IClassFactory)) 
  
   48. 
   { 
  
   49. 
   *ppv = (IClassFactory *) this; 
  
   50. 
   _AddRef();    
  
   51. 
   return S_OK; 
  
   52. 
   } 
  
   53. 
   return E_NOINTERFACE; 
  
   54. 
   } 
  
   55. 
     
   56. 
   STDMETHODIMP CreateInstance(LPUNKNOWN pUnkOuter, REFIID riid, LPVOID *ppvObj) 
  
   57. 
   { 
  
   58. 
   *ppvObj = NULL; 
  
   59. 
   if (pUnkOuter) 
  
   60. 
   return CLASS_E_NOAGGREGATION; 
  
   61. 
   m_pObj = CreateObject();  // m_pObj 在creatorClass中定义 
  
   62. 
   if (!m_pObj) 
  
   63. 
   return E_OUTOFMEMORY; 
  
   64. 
   HRESULT hr = m_pObj->QueryInterface(riid, ppvObj); 
  
   65. 
   if(hr != S_OK) 
  
   66. 
   { 
  
   67. 
   delete m_pObj; 
  
   68. 
   } 
  
   69. 
   return hr; 
  
   70. 
   } 
  
   71. 
     
   72. 
   STDMETHODIMP LockServer(BOOL) { return S_OK; }   // 未实现 
  
   73. 
   };