3

嗨,我有一个纯 C++ 项目 (DLL),我想将其转换为 COM 项目,例如,在标头中定义的所有公共接口现在都将公开为 COM 接口(IDL 等...)。最终产品应该是COM Dll。

我该如何开始?如何定义任何高级指南?好文章?

4

2 回答 2

3

这个问题至少有两个部分:

首先,COM 对象是使用CoCreateInstance创建的。CoCreateInstance 在内存中查找 COM 注册(通过CoRegisterClassObject),在应用程序清单中作为零注册 COM 对象,最后在注册表中。

对于零注册,创建一个描述您的 dll 的程序集清单,以便您的对象的消费者可以添加一个依赖程序集引用到他们的应用程序清单

那么,一个 COM dll 至少需要两个入口点:DllGetClassObjectDllCanUnloadNow

DllGetClassObject通过创建工厂对象的实例来实现 - 支持IClassFactory- 可用于制作实际对象的实例。

所以,总结一下——一种实现 COM dll 的 TDD 驱动方法:

  1. 使用“DllGetClassObject”和“DllCanUnloadNow”入口点创建一个 DLL。
  2. 创建一个新的 GUID 来表示您的对象,并创建一个程序集清单来描述您的 dll(将)包含的 COM 对象。
  3. CoCreateInstance创建一个使用该 GUID调用的测试应用程序。
  4. 调用 CoCreateInstance 现在应该在您的 DllGetClassObject 调用中着陆。实现类工厂对象。
  5. 实现CreateInstance方法以创建 c++ 类的新实例。确保您的所有接口都来自(至少)IUnknown。在您自己新创建的对象上调用 QueryInterface 以获取并返回所需的接口。

假设 Visual Studio(Express 可以)是您的构建环境:

创建一个测试exe:

// main.cpp
#include <windows.h>
#include <objbase.h>
#include <initguid.h>
DEFINE_GUID(CLSID_RegFreeOcx,0x00000000,0x0000,0x0000,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00);
#if defined _MSC_VER 
#if !defined _WINDLL && !defined (_CONSOLE)
#pragma comment(linker, "/subsystem:windows /ENTRY:mainCRTStartup")
#endif
#endif
#pragma comment(linker, "/manifestDependency:\"name='acme.RegFreeOcx' processorArchitecture='*' version='1.0.0.0' type='win32' \"")
int main(){
  CoInitialize(NULL);
  IUnknown* pUnk;
  CoCreateInstance(CLSID_RegFreeOcx,NULL,CLSCTX_ALL,IID_IUnknown,(void**)&pUnk);
  if(pUnk)
    pUnk->Release();
}

为 COM dll 的无注册激活创建清单:

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <assemblyIdentity name="Acme.RegFreeOcx" processorArchitecture="x86" version="1.0.0.0" type="win32" />
  <file name = "RegFreeOcx.dll">
    <comClass clsid="{00000000-0000-0000-0000-000000000000}" threadingModel="Apartment" />
  </file>
</assembly>

创建一个dll项目

// dllmain.cpp
#include <windows.h>
#pragma comment(linker,"/export:DllGetClassObject=_DllGetClassObject@12,PRIVATE")
#pragma comment(linker,"/export:DllCanUnloadNow=_DllCanUnloadNow@0,PRIVATE")
#include <objbase.h>
#include <initguid.h>
DEFINE_GUID(CLSID_RegFreeOcx,0x00000000,0x0000,0x0000,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00);
#include "MyClassFactory.hpp"

STDAPI DllGetClassObject(REFCLSID clsid, REFIID riid,void** ppvObj)
{
  if(CLSID_RegFreeOcx == clsid){
    MyClassFactory* pFactory = new MyClassFactory();
    HRESULT result = pFactory->QueryInterface(riid,ppvObj);
    pFactory->Release();
    return result;
  }
 return E_FAIL;
}
STDAPI DllCanUnloadNow()
{
  return E_FAIL;
}

//MyClassFactory.hpp
#include <MyClass.hpp>
class MyClassFactory : public IClassFactory {
  volatile ULONG _cRef;
public:
  MyClassFactory():_cRef(1){}
  virtual ~MyClassFactory(){}
public: // IUnknown
  STDMETHODIMP_(ULONG)AddRef(){
    return InterlockedIncrement(&_cRef);
  }
  STDMETHODIMP_(ULONG)Release(){
    ULONG result = InterlockedDecrement(&_cRef);
    if(!result) delete this;
    return result;
  }
  STDMETHODIMP QueryInterface(REFIID riid, void** ppvObj){
    if(riid == IID_IUnknown || riid == IID_IClassFactory)
      *ppvObj = (IClassFactory*)this;
    else { 
      *ppvObj=0;
       return E_NOINTERFACE;
    }
    AddRef();
    return S_OK;
  }
public: // IClassFactory
  STDMETHODIMP CreateInstance(IUnknown* pUnkOuter,REFIID riid,void** ppvObj){
    if(pUnkOuter)
      return E_INVALIDARG;
    MyClass* pClass = new MyClass();
    HRESULT result = pClass->QueryInterface(riid,ppvObj);
    pClass->Release();
    return result;
  }
  STDMETHODIMP LockServer(BOOL fLock){
    return E_NOTIMPL;
  }
};

最后,定义你自己的类。您可以使用 IDL 来执行此操作,但对于其他 cpp 使用者,您可以在头文件中定义它。

// IMyClass.h
#include <objbase.h>
DEFINE_GUID(IID_MyInterface,0x00000000,0x0000,0x0000,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00);
interface IMyInterface : IUnknown {
  STDMETHOD(MyMethod)(void)PURE;
};

在 cpp 文件中实现实现 IMyInterface 的类的实现方式与实现 ClassFactory 的方式非常相似(就 IUnknown 方法而言) - 用您自己的接口交换对 IClassFactory 的引用。

于 2012-08-14T09:51:13.187 回答
1

规范的温和介绍是Dale Rogenson 的Inside COM。要获得真正的深度,请尝试Don Box 的 Essential COM

需要担心的三大领域是:

  • 穿线
  • 内存管理和内存所有权约定]
  • 跨 COM 接口边界传递的类型 - 特别是不使用 STL

The Box book 还涵盖了人们使用 COM 做的一些非常讨厌的事情——比如免费的线程编组器——如果你的库已经是线程安全的并且你想避免编组惩罚,那么你可能会适用它。

于 2012-08-14T09:13:02.160 回答