嗨,我有一个纯 C++ 项目 (DLL),我想将其转换为 COM 项目,例如,在标头中定义的所有公共接口现在都将公开为 COM 接口(IDL 等...)。最终产品应该是COM Dll。
我该如何开始?如何定义任何高级指南?好文章?
嗨,我有一个纯 C++ 项目 (DLL),我想将其转换为 COM 项目,例如,在标头中定义的所有公共接口现在都将公开为 COM 接口(IDL 等...)。最终产品应该是COM Dll。
我该如何开始?如何定义任何高级指南?好文章?
这个问题至少有两个部分:
首先,COM 对象是使用CoCreateInstance创建的。CoCreateInstance 在内存中查找 COM 注册(通过CoRegisterClassObject),在应用程序清单中作为零注册 COM 对象,最后在注册表中。
对于零注册,创建一个描述您的 dll 的程序集清单,以便您的对象的消费者可以添加一个依赖程序集引用到他们的应用程序清单。
那么,一个 COM dll 至少需要两个入口点:DllGetClassObject和DllCanUnloadNow
您DllGetClassObject
通过创建工厂对象的实例来实现 - 支持IClassFactory
- 可用于制作实际对象的实例。
所以,总结一下——一种实现 COM dll 的 TDD 驱动方法:
CoCreateInstance
创建一个使用该 GUID调用的测试应用程序。假设 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 的引用。
规范的温和介绍是Dale Rogenson 的Inside COM。要获得真正的深度,请尝试Don Box 的 Essential COM
需要担心的三大领域是:
The Box book 还涵盖了人们使用 COM 做的一些非常讨厌的事情——比如免费的线程编组器——如果你的库已经是线程安全的并且你想避免编组惩罚,那么你可能会适用它。