COM

 

什么是COM?

简单地说,COM提供了一种在不同的应用程序和语言之间共享二进制代码的规范。COM定义了软件组件互相通讯的方式。它是一种二进制和网络标准,允许任意两个组件互相通讯,而不管它们是在什么计算机上运行(只要计算机是相连的),也不管计算机运行的是什么操作系统(只要该操作系统支持COM),也不管该组件是用什么语言编写的。COM还提供了位置透明性:当使用COM组件时,该组件是进程内Dll、本地exe还是位于其他机器上的组件,都无所谓。

为什么需要COM?

虽然可能有很多历史的原因,但是,我们仅从二进制代码共享的角度来看看,为什么要引入COM。

Windows可以使用DLLs在二进制级别共享代码,如kernel32.dll、user32.dll等。但是,这些dll都采用C接口,它们仅能被C语言或者能够理解C调用规范的语言使用。这从语言层次上限定了二进制代码的共享范围。

MFC有一种被称为MFC扩展DLL的共享机制。但是你只能在MFC应用程序中使用它们。

COM利用定义一个二进制规范来解决这些问题。使用COM编写的二进制模块必须匹配一些特定的数据结构。COM规范同样也定义COM对象在内存中应该如何被组织。这份二进制代码同样也不能依赖任何语言层面的特征。

COM对象的结构使用与C++虚函数相同的结构。所以很多COM使用C++编写,但是严格来说COM与编写该COM的语言是不想关的,因为最后的二进制代码可以被任何语言使用。

COM并不是Win32相关的,理论上,COM可以被移植到任何操作系统上,但是现实中COM依然只是Windows世界的东西。

COM基本术语

1.interface:一个接口可以看做是一组称为方法的函数。接口名以"I"打头,如"IShellLink",在C++中,接口即是一个只含有纯虚函数的抽象基类。

2.coclass:component object class的简称。coclass用来实现接口。一个COM对象是coclass在内存中的一个实例(instance)。注意COM"class"跟C++"class"不是一个东西,虽然COM class 的实现通常都是C++ class。

3.COM Server:含有一个或多个coclass的二进制模块(DLL或者EXE)。

4.Registration:向Windows注册,登记COM Server的位置和入口。Unregistration是一个相反的过程:从Windows中移除掉这个登记。

5.GUID:globally unique identifier。一个128位的数。COM使用语言无关的GUID作为标识。每一个interface和coclass都有一个GUID,因为GUID是全世界范围内唯一的。所以避免了名字冲突。有时候GUID也被称为UUID(universally unique identifier)。一个coclass的class ID称为CLSID;一个interface的interfaceID称为IID。

6.HRESULT:一个整数类型的值,COM使用它来返回成功或者错误码。可以使用Windows错误码查询来获取HRESULT所代表的字符含义。

基接口(base interface):IUnknown

每一个COM接口都要从IUnknown接口继承。IUnknown这个名字的含义是:如果你拥有一个指向IUnknown接口的COM对象指针,那个你无从知道它真正指向的对象是什么,因为COM中的每一个对象都实现了这个接口。

这个接口有三个方法:AddRef、Release和QueryInterface。其中QueryInterface用于在获取某个COM的一个接口指针后,查询该COM的其他接口指针。

HRESULT IUnknown::QueryInterface (
    REFIID iid,
    void** ppv );使用COM

1.创建一个COM对象:C++中使用new操作符或者直接在栈上创建;创建COM对象则要调用COM library中的一个API(CoCreateInstance)。

2.删除COM对象:C++中,使用delete操作符或者在栈上的对象超出作用域以后会自动析构。但是在COM中,所有的对象拥有它们自己的引用计数(reference count)。调用者必须在使用完COM对象以后通知它(减少引用计数)。COM对象在引用计数到达0时,自动从内存中释放自己。

创建COM对象的函数原型如下:

HRESULT CoCreateInstance (
    REFCLSID  rclsid,
    LPUNKNOWN pUnkOuter,
    DWORD     dwClsContext,
    REFIID    riid,
    LPVOID*   ppv );参数说明:

rclsid
coclass的CLSID。例如,你可以传递CLSID_ShellLink来创建一个用于创建快捷方式的COM对象。
pUnkOuter
只在使用聚合COM对象的时候有用。如果不是用,则传递NULL。
dwClsContext
指示我们希望使用什么类型的COM Server。这里我们使用最简单的一种Server,an in-process DLL,传递 CLSCTX_INPROC_SERVER。
riid
我们要使用的接口的IID。例如,传递IID_IShellLink来得到IShellLink interface的指针。
ppv
所请求的接口的指针地址。
当调用CoCreateInstance函数时,它查询注册表中的CLSID,读取COM server的位置,将其加载到内存中并创建函数所请求的coclass的一个实例。需要注意的是,在使用函数CoCreateInstance之前,确保你的程序已经初始化了COM library,并且需要在程序退出时卸载它,分别调用CoInitialize和CoUninitialize函数。

-----------------COM object create sample-------------------------------------------------------

HRESULT hr;
    IShellLink* pISL;
    hr = CoCreateInstance(CLSID_ShellLink,
        NULL,
        CLSCTX_INPROC_SERVER,
        IID_IShellLink,
        (void*)&pISL);
    if (SUCCEEDED(hr))
    {
        pISL->Release();//just release.
    }
    else
    {
    }

---------------------------------------------------------------------------------------------------------

COM中的字符串操作

只要注意到COM中的字符串都是Unicode的,就应该没有问题的。习惯于使用Unicode并在与COM的交互中使用Unicode,就不会有任何问题。当使用ANSI时,需要自己处理Unicode与ANSI之间的转换。除了常规的转换方法外,ATL提供了几个宏处理这种转换:W2A()、OLE2A()、OLE2CA()等。

一个完整的使用COM的样例代码通常如下,代码从参考文章中copy的:

------------------------------------------------------------------------------------------------------------------------

CString       sWallpaper = wszWallpaper;  // Convert the wallpaper path to ANSI
IShellLink*   pISL;
IPersistFile* pIPF;

    // 1. Initialize the COM library (make Windows load the DLLs). Normally you would
    // call this in your InitInstance() or other startup code.  In MFC apps, use
    // AfxOleInit() instead.
    CoInitialize ( NULL );

    2. Create a COM object, using the Shell Link coclass provided by the shell.
    // The 4th parameter tells COM what interface we want (IShellLink).
    hr = CoCreateInstance ( CLSID_ShellLink,
                            NULL,
                            CLSCTX_INPROC_SERVER,
                            IID_IShellLink,
                            (void**) &pISL );

    if ( SUCCEEDED(hr) )
        {
        // 3. Set the path of the shortcut's target (the wallpaper file).
        hr = pISL->SetPath ( sWallpaper );

        if ( SUCCEEDED(hr) )
            {
            // 4. Get a second interface (IPersistFile) from the COM object.
            hr = pISL->QueryInterface ( IID_IPersistFile, (void**) &pIPF );

            if ( SUCCEEDED(hr) )
                {
                // 5. Call the Save() method to save the shortcut to a file.  The
                // first parameter is a Unicode string.
                hr = pIPF->Save ( L"C://wallpaper.lnk", FALSE );

                // 6a. Release the IPersistFile interface.
                pIPF->Release();
                }
            }

        // 6b. Release the IShellLink interface.
        pISL->Release();
        }

    // Printing of error messages omitted here.

    // 7. Uninit the COM library.  In MFC apps, this is not necessary since MFC
    // does it for us.
    CoUninitialize();------------------------------------------------------------------------------------------------------------------------

编写COM

下面看看一个最简单的COM server,进程内server(in-process server),需要如何编写。

要想能用COM lib来使用该COM server,首先必须做两件事情:

1.必须在注册表HKEY_CLASSES_ROOT/CLSID下注册自己;

2.必须导出一个称为DllGetClassObject的函数。

这是这个COM的最低配置。需要在该注册表项下创建一个以该GUID为名的键,该键下有包含一系列的键值,如COM的位置以及它的线程模型等。

一般情况下,COM还需要导出下面三个函数:

•DllCanUnloadNow(): COM lib调用此函数以判断该server是否可以被卸载;
•DllRegisterServer(): 由安装工具调用,像RegSvr32一样让server能够注册自身。
•DllUnregisterServer(): 由卸载工具调用,用于卸载COM。
前面说道每一个接口都必须实现IUnknown接口,因为IUnknown接口包含了COM对象的两个基本特征:引用计数和接口查询。在写coclass时,也必须实现该接口。下面是一个简单的coclass:

-----------------------------------------------------------------------------------------------------------------------------

class CUnknownImpl : public IUnknown
{
public:
    // Construction and destruction
    CUnknownImpl();
    virtual ~CUnknownImpl();

    // IUnknown methods
    ULONG AddRef();
    ULONG Release)();
    HRESULT QueryInterface( REFIID riid, void** ppv );

protected:
    UINT m_uRefCount;  // object's reference count
};HRESULT CUnknownImpl::QueryInterface ( REFIID riid, void** ppv )
{
HRESULT hrRet = S_OK;

    // Standard QI() initialization - set *ppv to NULL.
    *ppv = NULL;

    // If the client is requesting an interface we support, set *ppv.
    if ( IsEqualIID ( riid, IID_IUnknown ))
        {
        *ppv = (IUnknown*) this;
        }
    else
        {
        // We don't support the interface the client is asking for.
        hrRet = E_NOINTERFACE;
        }

    // If we're returning an interface pointer, AddRef() it.
    if ( S_OK == hrRet )
        {
        ((IUnknown*) *ppv)->AddRef();
        }

    return hrRet;
}-----------------------------------------------------------------------------------------------------------------------------

在每一次实现一个coclass时,同时也需要写一个被称为class factory配对的类,该类用于创建这个coclass的实例。需要这个工厂类的原因是为了语言无关:COM本身不创建COM对象,因为那样的话就不是语言和实现无关的了。

当COM lib调用DllGetClassObject时,它传递COM客户端请求的CLSID,server创建代表这个CLSID的类工厂。工厂类(class factory)本身也是一个coclass,它实现了IClassFactory。当DllGetClassObject成功返回时,它返回给COM lib一个指向IClassFactory的指针,然后COM lib使用IClassFactory的方法来创建COM对象。

IClassFactory像下面这样:

struct IClassFactory : public IUnknown
{
    HRESULT CreateInstance( IUnknown* pUnkOuter, REFIID riid,
                            void** ppvObject );
    HRESULT LockServer( BOOL fLock );
};在这之后我们需要用COM实现自己的功能,首先定义一个接口,接口里包含了我们自己的功能定义(记住,它必须实现IUnknown接口),例如:struct ISimpleMsgBox : public IUnknown
{
    // IUnknown methods
    ULONG AddRef();
    ULONG Release();
    HRESULT QueryInterface( REFIID riid, void** ppv );

    // ISimpleMsgBox methods
    HRESULT DoSimpleMsgBox( HWND hwndParent, BSTR bsMessageText );
};

struct __declspec(uuid("{7D51904D-1645-4a8c-BDE0-0F4A44FC38C4}"))
                  ISimpleMsgBox;注意到最后一行,__declspec表示将一个GUID分配给ISimpleMsgBox,然后我们可以使用__uuidof操作符来获取这个GUID,__declspec和__uuidof都是微软的C++扩展(Microsoft C++ extensions)。然后,你需要一个类来实现这个接口:class CSimpleMsgBoxImpl : public ISimpleMsgBox 
{
public:
 CSimpleMsgBoxImpl();
 virtual ~CSimpleMsgBoxImpl();

    // IUnknown methods
    ULONG AddRef();
    ULONG Release();
    HRESULT QueryInterface( REFIID riid, void** ppv );

    // ISimpleMsgBox methods
    HRESULT DoSimpleMsgBox( HWND hwndParent, BSTR bsMessageText );

protected:
    ULONG m_uRefCount;
};

class  __declspec(uuid("{7D51904E-1645-4a8c-BDE0-0F4A44FC38C4}"))
                  CSimpleMsgBoxImpl;其他细节:与COM有关的宏STDMETHOD():包含了virtual关键字和HRESULT返回类型以及__stdcall调用约定。STDMETHOD_()与之相同,但是允许指定非HRESULT的返回值。PURE:与C++中的"=0"效果相同,将一个函数声明为纯虚函数。STDMETHODIMP:对应于STDMETHOD()的实现,相应地,STDMETHODIMP_()与STDMETHOD_()对应。STDAPI:包含了返回类型和调用约定,由于STDAPI的扩展方式,使用了此宏以后不能再使用__declspec(dllexport)。可以使用".DEF"文件完成类似功能。还有一些实现上的问题,就不多讲了,千言万语,都在代码里面:)。本文完全基于下面两篇英文文章,作了一个简单的理解和翻译,代码也请到下面的链接地址里下载。

 

http://blog.csdn.net/winglet/article/details/2872342

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值