C# 互操作（一） 编写一个C++ COM组件

    C# 如何与C++ 编写的COM 组件进行交互，首先编写一个C++ ATL COM 组件，打开vs，新建一个ATL项目，将项目命名为COMServer，在Application Setting中，选择Dynamic Link Library（动态链接库）。创建项目后，右键点击项目，添加-类，选择ATL标签，选择ATL Simple Object （ATL 简单对象），在对话框中简称填写COMDemo，接口填写IWelcome，ProgId填写COMServer.COMDemo

然后在类视图下，选择接口IWelcome，并使用下面的参数添加方法Greeting

HRESULT Greeting( [in] BSTR name, [out,retval] BSTR* message);

IDL 文件COMServer.idl 定义了COM的接口，向导在COMServer.idl文件中生成的代码应该与下面类似，唯一标识符（uuid）会不同。IWelcome接口定义了Greeting方法，关键字interface之前的中括号定义了该接口的一些特性。uuid定义额了接口ID，dual标记了接口类型。

[
    object,
    uuid(4704A15D-CDE1-4BF1-A28E-E1477E7C74B8),
    dual,
    nonextensible,
    pointer_default(unique)
]
interface IWelcome : IDispatch
{
    [id(1)] HRESULT Greeting([in] BSTR name, [out, retval] BSTR* message);
};

IDL文件也定义了类型库的内容，它是实现了IWelcome接口的COM对象（coclass）

[
    uuid(FBB80A75-06E1-452B-88BA-F7B00ED151A9),
    version(1.0),
]
library COMServerLib
{
    [
        uuid(85567ACE-7031-4246-9E81-CA5AA470F212),
    ]
    coclass COMDemo
    {
        [default] interface IWelcome;
    };
};

在IWelcome接口的头部，使用上述标识符和名称Learning.Interop.Server.IWelcome添加custom特性。在coclass COMDemo中使用对应的名称天界类似的custom特性：

[
    object,
    uuid(4704A15D-CDE1-4BF1-A28E-E1477E7C74B8),
    dual,
    nonextensible,
    pointer_default(unique),
    custom(67412B27-B0FB-425A-A7D2-DAB66BD6768B, "Learning.Interop.Server.IWelcome")
]
interface IWelcome : IDispatch
{
    [id(1)] HRESULT Greeting([in] BSTR name, [out, retval] BSTR* message);
};

[
    uuid(FBB80A75-06E1-452B-88BA-F7B00ED151A9),
    version(1.0),
]
library COMServerLib
{
    [
        uuid(85567ACE-7031-4246-9E81-CA5AA470F212),
        helpstring("COMDemo Class"),
        custom(67412B27-B0FB-425A-A7D2-DAB66BD6768B, "Learning.Interop.Server.COMDemo")
    ]
    coclass COMDemo
    {
        [default] interface IWelcome;
    };
};

现在可以在COMServer.idl文件中再添加一个接口，可以把IWelcome的接口头部直接复制到新建的IMath接口的头部，但要记得修改uuid关键字定义的唯一标识符。

IMath接口提供两个方法Add，Sub：

//IMath
[
    object,
    uuid(2158751B-B96E-461d-9012-EF1680BE0628),
    dual,
    nonextensible,
    pointer_default(unique),
    custom(67412B27-B0FB-425A-A7D2-DAB66BD6768B, "Learning.Interop.Server.IMath")
]
interface IMath : IDispatch
{
    
    [id(1)] HRESULT Add([in] LONG val1, [in] LONG val2, [out, retval] LONG* result);
    [id(2)] HRESULT Sub([in] LONG val1, [in] LONG val2, [out, retval] LONG* result);
};

还必须修改coclass COMDemo，使其同时实现接口IWelcome和IMath。IWelcome接口设为默认接口：

[
    uuid(85567ACE-7031-4246-9E81-CA5AA470F212),
    helpstring("COMDemo Class"),
    custom(67412B27-B0FB-425A-A7D2-DAB66BD6768B, "Learning.Interop.Server.COMDemo")
]
coclass COMDemo
{
    [default] interface IWelcome;
    interface IMath;
};

现在可以将注意力从IDL文件转移到C++代码。COMDemo.h文件包含了COM对象的定义。类COMDemo使用多继承派生自模板类CComObjectRootEx,CComCoClass 和 IDispatchImpl.CComObjectRootEx 类实现了IUnknow接口的功能，例如AddRef和Release方法。CComCoClass类创建了一个工厂实例化模板参数对象，在这里是CComDemo。IDispatchImple实现了IDispathc接口的方法。

包含在BEGIN_COM_MAP 和 END_COM_MAP中的宏创建了一个映射，用于定义COM类实现的所有COM接口。QuerInterface方法的实现会使用此映射

class ATL_NO_VTABLE CCOMDemo :
    public CComObjectRootEx<CComSingleThreadModel>,
    public CComCoClass<CCOMDemo, &CLSID_COMDemo>,
    public IDispatchImpl<IWelcome, &IID_IWelcome, &LIBID_COMServerLib, /*wMajor =*/ 1, /*wMinor =*/ 0>,
{
public:
    CCOMDemo()
    {
    }

DECLARE_REGISTRY_RESOURCEID(IDR_COMDEMO1)


BEGIN_COM_MAP(CCOMDemo)
    COM_INTERFACE_ENTRY(IWelcome)
    COM_INTERFACE_ENTRY2(IDispatch,IWelcome)
END_COM_MAP()



    DECLARE_PROTECT_FINAL_CONSTRUCT()

    HRESULT FinalConstruct()
    {
        return S_OK;
    }

    void FinalRelease()
    {
    }

public:



    STDMETHOD(Greeting)(BSTR name, BSTR* message);
};

OBJECT_ENTRY_AUTO(__uuidof(COMDemo), CCOMDemo)

在这个类定义中，还需要添加第二接口IMath，以及IMath接口定义的方法：

class ATL_NO_VTABLE CCOMDemo :
    public CComObjectRootEx<CComSingleThreadModel>,
    public CComCoClass<CCOMDemo, &CLSID_COMDemo>,
public IDispatchImpl<IWelcome, &IID_IWelcome, &LIBID_COMServerLib, /*wMajor =*/ 1, /*wMinor =*/ 0>,
    public IDispatchImpl<IMath, &IID_IMath, &LIBID_COMServerLib, 1, 0>,
{
public:
    CCOMDemo()
    {
    }

DECLARE_REGISTRY_RESOURCEID(IDR_COMDEMO1)


BEGIN_COM_MAP(CCOMDemo)
    COM_INTERFACE_ENTRY(IWelcome)
    COM_INTERFACE_ENTRY(IMath)
    COM_INTERFACE_ENTRY2(IDispatch,IWelcome)
END_COM_MAP()



    DECLARE_PROTECT_FINAL_CONSTRUCT()

    HRESULT FinalConstruct()
    {
        return S_OK;
    }

    void FinalRelease()
    {
    }

public:



    STDMETHOD(Greeting)(BSTR name, BSTR* message);
    STDMETHOD(Add)(LONG val1, LONG val2, LONG* result);
    STDMETHOD(Sub)(LONG val1, LONG val2, LONG* result);
};

OBJECT_ENTRY_AUTO(__uuidof(COMDemo), CCOMDemo)

现在可以关注一下COMDemo.cpp了，在cpp文件中实现头文件中声明的方法：

STDMETHODIMP CCOMDemo::Greeting(BSTR name, BSTR* message)
{
    // TODO:  在此添加实现代码
    CComBSTR tmp("Welcome, ");
    tmp.Append(name);
    *message = tmp;
    return S_OK;
}

STDMETHODIMP CCOMDemo::Add(LONG val1, LONG val2, LONG* result)
{
    *result = val1 + val1;
    Fire_Completed();
    return S_OK;
}

STDMETHODIMP CCOMDemo::Sub(LONG val1, LONG val2, LONG* result)
{
    *result = val1 - val2;
    Fire_Completed();
    return S_OK;
}

现在就可以生成组件了。生成过程会在注册表中配置组件，需要管理员身份，所以请务必以管理员身份运行VS。