Developing COM Components using VC-ATL(2-6)

类别:VC语言 点击:0 评论:0 推荐:

 

六、MyCom.h

     代码选取

// MyCom.h : Declaration of the CMyCom

#ifndef __MYCOM_H_

#define __MYCOM_H_

#include "resource.h"       // main symbols

// CMyCom

class ATL_NO_VTABLE CMyCom :

         public CComObjectRootEx<CComSingleThreadModel>,

         public CComCoClass<CMyCom, &CLSID_MyCom>,

         public IDispatchImpl<IMyCom, &IID_IMyCom, &LIBID_MYPROJLib>

{

public:

         CMyCom(){}

 

DECLARE_REGISTRY_RESOURCEID(IDR_MYCOM)

DECLARE_PROTECT_FINAL_CONSTRUCT()

 

BEGIN_COM_MAP(CMyCom)

         COM_INTERFACE_ENTRY(IMyCom)

         COM_INTERFACE_ENTRY(IDispatch)

END_COM_MAP()

 

// IMyCom

public:

         STDMETHOD(MyF4)(/*[in]*/ int x,/*[out, retval]*/ int* val);

         STDMETHOD(MyF3)(/*[in]*/ BSTR str,/*[out, retval]*/ BSTR* retstr);

         STDMETHOD(MyF2)(/*[in]*/ BSTR str,/*[out, retval]*/ int* val);

         STDMETHOD(MyF1)();

};

 

#endif //__MYCOM_H_

代码剖析

n          CComObjectRootEx

是每个COM组件必须继承的类之一,这个类管理组件的引用计数。由于引用计数是很重要的,所有的ATL COM组件必须从CComObjectRootEx继承。

n          CComCoClass

如果一个类从CComCoClass继承,ATL确保了这个类一定是默认的类工厂对象。ATL支持一个默认的工厂实现,并且有使得可以恢复对象CLSID和设置错误信息的函数。

n          BEGIN_COM_MAP(CMyCom)

         COM_INTERFACE_ENTRY(IMyCom)

         COM_INTERFACE_ENTRY(IDispatch)

END_COM_MAP()

BEGIN_COM_MAP和END_COM_MAP这两个宏定义了COM的接口映射。列在映射中的接口是QueryInterface可以返回的接口指针的接口。

n          另外CComObject类实现了属于IUnKnown接口的方法。这个类一直是最大的派生类,它提供了聚合和锁模型的选择。但是,对QueryInterface、AddRef、Release的调用会委派给CComObjectRootEx

n          还有,我们在这里看到了和接口定义语言文件模样差不多的四个函数的声明

         STDMETHOD(MyF4)(/*[in]*/ int x,/*[out, retval]*/ int* val);

         STDMETHOD(MyF3)(/*[in]*/ BSTR str,/*[out, retval]*/ BSTR* retstr);

         STDMETHOD(MyF2)(/*[in]*/ BSTR str,/*[out, retval]*/ int* val);

         STDMETHOD(MyF1)();

         那么它们两者间有什么意义区别呢?

         在接口定义语言文件里有如下接口函数(方法)

         interface IMyCom : IDispatch

         {

                   [id(1), helpstring("method MyF1")] HRESULT MyF1();

                   [id(2), helpstring("method MyF2")] HRESULT MyF2([in] BSTR str,[out, retval] int* val);

                   [id(3), helpstring("method MyF3")] HRESULT MyF3([in] BSTR str,[out, retval] BSTR* retstr);

                   [id(4), helpstring("method MyF4")] HRESULT MyF4([in] int x,[out, retval] int* val);

         };

         这都是对接口而言的,接口只是包含了这些函数的集合,它并没有实现这些函数。函数是通过组件类(CMyCom class)实现的。组件类实例化时生成组件对象。

 

七、MyCom.cpp

     代码选取

// MyCom.cpp : Implementation of CMyCom

#include "stdafx.h"

#include "MyProj.h"

#include "MyCom.h"

// CMyCom

STDMETHODIMP CMyCom::MyF1()

{

         AFX_MANAGE_STATE(AfxGetStaticModuleState())

         // TODO: Add your implementation code here

         AfxMessageBox("欢迎使用我的组件");

         return S_OK;

}

代码剖析

组件类对接口函数的具体实现。

 

八、MyProj.h

    代码选取

    略

    代码剖析

    虚函数表等内部定义

 

九、MyProj.cpp

    代码选取

// MyProj.cpp : Implementation of DLL Exports.

// Note: Proxy/Stub Information

//      To build a separate proxy/stub DLL,

//      run nmake -f MyProjps.mk in the project directory.

#include "stdafx.h"

#include "resource.h"

#include <initguid.h>

#include "MyProj.h"

#include "MyProj_i.c"

#include "MyCom.h"

CComModule _Module;//

BEGIN_OBJECT_MAP(ObjectMap)

OBJECT_ENTRY(CLSID_MyCom, CMyCom)//对象MAP,对每个服务器实现有组件都有一个入口

END_OBJECT_MAP()

class CMyProjApp : public CWinApp

{

public:

// Overrides

         // ClassWizard generated virtual function overrides

         //{{AFX_VIRTUAL(CMyProjApp)

         public:

    virtual BOOL InitInstance();

    virtual int ExitInstance();

         //}}AFX_VIRTUAL

         //{{AFX_MSG(CMyProjApp)

                   // NOTE - the ClassWizard will add and remove member functions here.

                   //    DO NOT EDIT what you see in these blocks of generated code !

         //}}AFX_MSG

         DECLARE_MESSAGE_MAP()

};

BEGIN_MESSAGE_MAP(CMyProjApp, CWinApp)

         //{{AFX_MSG_MAP(CMyProjApp)

                   // NOTE - the ClassWizard will add and remove mapping macros here.

                   //    DO NOT EDIT what you see in these blocks of generated code!

         //}}AFX_MSG_MAP

END_MESSAGE_MAP()

CMyProjApp theApp;

BOOL CMyProjApp::InitInstance()

{

    _Module.Init(ObjectMap, m_hInstance, &LIBID_MYPROJLib);

    return CWinApp::InitInstance();

}

int CMyProjApp::ExitInstance()

{

    _Module.Term();

    return CWinApp::ExitInstance();

}

// Used to determine whether the DLL can be unloaded by OLE

STDAPI DllCanUnloadNow(void)

{

    AFX_MANAGE_STATE(AfxGetStaticModuleState());

    return (AfxDllCanUnloadNow()==S_OK && _Module.GetLockCount()==0) ? S_OK : S_FALSE;

}

// Returns a class factory to create an object of the requested type

STDAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID* ppv)

{

    return _Module.GetClassObject(rclsid, riid, ppv);

}

// DllRegisterServer - Adds entries to the system registry

STDAPI DllRegisterServer(void)

{

    // registers object, typelib and all interfaces in typelib

    return _Module.RegisterServer(TRUE);

}

// DllUnregisterServer - Removes entries from the system registry

STDAPI DllUnregisterServer(void)

{

    return _Module.UnregisterServer(TRUE);

}

 

本文地址:http://com.8s8s.com/it/it1301.htm