基于VC編寫COM連接點事件的分析介紹

更新時間：2013年05月17日 12:30:07 作者：

本篇文章是對VC編寫COM連接點事件進行了詳細的分析介紹，需要的朋友參考下

COM 中的典型方案是讓客戶端對象實例化服務器對象，然后調(diào)用這些對象。然而，沒有一種特殊機制的話，這些服務器對象將很難轉(zhuǎn)向并回調(diào)到客戶端對象。COM 連接點便提供了這種特殊機制，實現(xiàn)了服務器和客戶端之間的雙向通信。使用連接點，服務器能夠在服務器上發(fā)生某些事件時調(diào)用客戶端。

原理如下圖：

有了連接點，服務器可通過定義一個接口來指定它能夠引發(fā)的事件。服務器上引發(fā)事件時，要采取操作的客戶端會向服務器進行自行注冊。隨后，客戶端會提供服務器所定義接口的實現(xiàn)。

客戶端可通過一些標準機制向服務器進行自行注冊。COM 為此提供了 IConnectionPointContainer 和 IConnectionPoint 接口。

COM 連接點服務器的客戶端可用 C++ 和 C# 托管代碼來編寫。C++ 客戶端會注冊一個類的實例，該類提供了接收器接口的實現(xiàn)。托管客戶端會注冊單個事件的委托，因而會按每個事件通知方法創(chuàng)建單個接收器，具體參考C#的互操作部分內(nèi)容。

一、連接點程序編寫
1、使用ATL建立組件程序。
2、添加ATL SIMPLE OBJECT，支持連接點事件。
注：如果當時沒有現(xiàn)在連接點事件，可以在.idl文件中手動添加。比如

復制代碼代碼如下:

 [
       uuid(57CCB7A5-F3B6-4990-91CD-33A82E1AAA46),
       helpstring("IFunEvent dispinterface")
    ]
    dispinterface _IFunEvent
    {
       properties:
           //  事件接口沒有任何屬性
       methods:
           [id(1), helpstring("方法OnResult")] HRESULT OnResult([out,retval] LONG* retval);
           [id(2), helpstring("方法OnType")] HRESULT OnType([in] LONG nType);
}

3、因為支持連接點事件，這樣將會自動生成一個 _XXXEVENT源接口。我們在其中增加想要觸發(fā)的方法。
4、選擇組件下的事件對象，彈出對話框選擇添加方法?？梢岳^續(xù)添加多個方法…
5、實現(xiàn)方法（其實組件里只是做方法的申明，客戶調(diào)用時才實現(xiàn)這些方法）。實現(xiàn)時選中組件/類，按右鍵，在彈出菜單中選中implement connection....
就會產(chǎn)生CProxy_xxxEvent類，里面有Fire函數(shù)的實現(xiàn)，都是自動生成的。
6、完成組件的其他接口函數(shù)。
組件的連接點編寫比較簡單，關鍵是如何在客戶端實現(xiàn)事件監(jiān)聽與接收。在.NET下很容易實現(xiàn)。但在VC中比較繁瑣。
二、連接點客戶端實現(xiàn)（VC）
1、包含“工程_i.h”頭文件，引入“工程.tlb”ole庫文件。比如：
#include "ATLDemo_i.h"
#import "ATLDemo.tlb" named_guids raw_interfaces_only
2、創(chuàng)建一個類：由_IXXXEvent派生過來。（XXX為實際事件名）
實現(xiàn)類各個虛函數(shù)重載，如果_IXXXEvent是IUnkown接口只需要重載QueryInterface、AddRef、Release函數(shù)；如果_IXXXEvent是雙向接口需要重載實現(xiàn)IUnkown接口三個函數(shù)和IDispatch接口四個函數(shù)。
實現(xiàn)事件功能，通過函數(shù)、用SINK_ENTRY_INFO實現(xiàn)事件的映射、Invoke函數(shù)里面實現(xiàn)（通過事件ID）三種方法之一來實現(xiàn)。
用SINK_ENTRY_INFO實現(xiàn)事件的映射
如：

復制代碼代碼如下:

BEGIN_SINK_MAP(CEventSink)
    SINK_ENTRY_INFO(1,DIID__INew01Events,DISPID_MSG,Msg,&MsgInfo)
END_SINK_MAP() 

我在組件中定義了一個Msf函數(shù)，所以在這里對其進行消息隱射。然后實現(xiàn)Msg方法。
3、如何調(diào)用
3.1使用工程支持COM，使用afxoleinit或者CoInitialize/Un CoInitialize
3.2得到組件接口
3.3得到連接點容器，查找連接點。
3.4利用Advise將一個監(jiān)聽對象傳給組件，這樣當事件發(fā)生的時候事件就會響應。在不使用時，通過UnAdvise來斷開連接點事件。同時也利用AfxConnectionAdvice將監(jiān)聽對象傳給組件接口。
3.5 釋放資源。
具體代碼如下：

復制代碼代碼如下:

#pragma once

#include "ATLDemo_i.h"
#import "ATLDemo.tlb" named_guids raw_interfaces_only

class CSkin : public _IFunEvent
{
public:
    CSkin(void);
    ~CSkin(void);
private:
    DWORD       m_dwRefCount;
public:
    STDMETHODIMP Fire_OnType( LONG nType)
    {
       CString    strTemp;
       strTemp.Format(_T("The result is %d"), nType);
       AfxMessageBox(strTemp);
       return S_OK;;
    }
    HRESULT STDMETHODCALLTYPE QueryInterface(REFIID iid, void **ppvObject)
    {
       if (iid == DIID__IFunEvent)
       {
           m_dwRefCount++;
           *ppvObject = (void *)this;
           return S_OK;
       }

       if (iid == IID_IUnknown)
       {
           m_dwRefCount++;           
           *ppvObject = (void *)this;
           return S_OK;
       }

       return E_NOINTERFACE;
    }
    ULONG STDMETHODCALLTYPE AddRef()
    {
       m_dwRefCount++;
       return m_dwRefCount;
    }

    ULONG STDMETHODCALLTYPE Release()
    {
       ULONG l;

       l  = m_dwRefCount--;

       if ( 0 == m_dwRefCount)
       {
           delete this;
       }

       return l;
    }

    HRESULT STDMETHODCALLTYPE GetTypeInfoCount(
       /* [out] */ __RPC__out UINT *pctinfo)
    {
       return S_OK;
    }

    HRESULT STDMETHODCALLTYPE GetTypeInfo(
       /* [in] */ UINT iTInfo,
       /* [in] */ LCID lcid,
       /* [out] */ __RPC__deref_out_opt ITypeInfo **ppTInfo)
    {
       return S_OK;
    }

     HRESULT STDMETHODCALLTYPE GetIDsOfNames(
       /* [in] */ __RPC__in REFIID riid,
       /* [size_is][in] */ __RPC__in_ecount_full(cNames) LPOLESTR *rgszNames,
       /* [range][in] */ UINT cNames,
       /* [in] */ LCID lcid,
       /* [size_is][out] */ __RPC__out_ecount_full(cNames) DISPID *rgDispId)
    {
       return S_OK;
    }

     /* [local] */ HRESULT STDMETHODCALLTYPE Invoke(
       /* [in] */ DISPID dispIdMember,
       /* [in] */ REFIID riid,
       /* [in] */ LCID lcid,
       /* [in] */ WORD wFlags,
       /* [out][in] */ DISPPARAMS *pDispParams,
       /* [out] */ VARIANT *pVarResult,
       /* [out] */ EXCEPINFO *pExcepInfo,
       /* [out] */ UINT *puArgErr)
    {
       switch(dispIdMember) // 根據(jù)不同的dispIdMember,完成不同的回調(diào)函數(shù)，事件函數(shù)的ID編號
       {
       case 2:
           {
              // 1st param : [in] long lValue.
              VARIANT varlValue;
              long lValue = 0;
              VariantInit(&varlValue);
              VariantClear(&varlValue);
              varlValue = (pDispParams->rgvarg)[0];
              lValue = V_I4(&varlValue);
              Fire_OnType(lValue);
           }
           break;
       default:   break;
       }

       return S_OK;
    }
};

#include "StdAfx.h"
#include "Skin.h"

CSkin::CSkin(void)
{
     m_dwRefCount =0;
}

CSkin::~CSkin(void)
{
}

實現(xiàn)部分：

復制代碼代碼如下:

CoInitialize(NULL);

    CComPtr<IFun> pFun;
    HRESULT hr = pFun.CoCreateInstance(CLSID_Fun);
    if(hr!=S_OK)
    {
       return ;
    }

    IConnectionPointContainer *pCPC;
    hr = pFun->QueryInterface(IID_IConnectionPointContainer,(void **)&pCPC);
    if(!SUCCEEDED(hr))
    {
       return ;
    }
    IConnectionPoint *pCP;
    hr = pCPC->FindConnectionPoint(DIID__IFunEvent,&pCP);
    if ( !SUCCEEDED(hr) )
    {
       return ;
    }
    pCPC->Release();

    IUnknown *pSinkUnk;
    CSkin *pSink = new CSkin();
    hr = pSink->QueryInterface(IID_IUnknown,(void **)&pSinkUnk);
    DWORD dwAdvise;
    hr = pCP->Advise(pSinkUnk,&dwAdvise);//接收器與連接點建立關聯(lián)

    LONG c = 0;
    pFun->Add(1,5,&c);
    //pCP->Unadvise(dwAdvise) //斷開連接點事件
    pCP->Release();
    pFun.Release();

    CoUninitialize();