使用MFC开发进程外COM组件 - 创建项目


写在前面

之前使用COM接口调用Excel的API时就对该产品的架构产生了浓厚的兴趣,但并COM、ATL、MFC等并不了解,网上也没有太多的资料。
得益于目前的工作,我接触到大量COM相关的知识,并根据网上搜索到的资料,实现了具有此架构的应用程序,在此做一下记录,希望能帮到需要的人。

安装Visual Studio

这部分省略,网上有很多教程,安装时请注意勾选ATLMFC支持。

创建项目

启动VS,创建新项目,项目模板为MFC应用
点击创建按钮,应用程序类型选择基于对话框,点击完成。

初始化APP

对话框需要由COM接口在初始化时创建,因此,我们需要对CAutoMFCAppInitInstance函数做一些修改:

HRESULT ExeRegisterClassObject(BOOL automationSpecified);
HRESULT ExeUnRegisterClassObject(void);

BOOL CAutoMFCApp::InitInstance()
{
    // 如果一个运行在 Windows XP 上的应用程序清单指定要
    // 使用 ComCtl32.dll 版本 6 或更高版本来启用可视化方式,
    //则需要 InitCommonControlsEx()。  否则,将无法创建窗口。
    INITCOMMONCONTROLSEX InitCtrls;
    InitCtrls.dwSize = sizeof(InitCtrls);
    // 将它设置为包括所有要在应用程序中使用的
    // 公共控件类。
    InitCtrls.dwICC = ICC_WIN95_CLASSES;
    InitCommonControlsEx(&InitCtrls);

    CWinApp::InitInstance();

    // OLE初始化
    if (!AfxOleInit())
    {
        return FALSE;
    }

    AfxEnableControlContainer();

    // 创建 shell 管理器,以防对话框包含
    // 任何 shell 树视图控件或 shell 列表视图控件。
    CShellManager *pShellManager = new CShellManager;

    // 激活“Windows Native”视觉管理器,以便在 MFC 控件中启用主题
    CMFCVisualManager::SetDefaultManager(RUNTIME_CLASS(CMFCVisualManagerWindows));

    // 标准初始化
    // 如果未使用这些功能并希望减小
    // 最终可执行文件的大小,则应移除下列
    // 不需要的特定初始化例程
    // 更改用于存储设置的注册表项
    // TODO: 应适当修改该字符串,
    // 例如修改为公司或组织名
    SetRegistryKey(_T("应用程序向导生成的本地应用程序"));

    CCommandLineInfo cmdInfo;
    ParseCommandLine(cmdInfo);

    BOOL bAutomationFlag = FALSE;
    // 是否以/automation或/embedding模式启动
    if (cmdInfo.m_bRunEmbedded || cmdInfo.m_bRunAutomated)
    {
        bAutomationFlag = TRUE;
    }
    ::ExeRegisterClassObject(bAutomationFlag);
    MSG msg = { 0 };
    int rVal = 0;
    while ((rVal = ::GetMessage(&msg, 0, 0, WM_USER)) != 0) {
        if (rVal == -1) {
            break;
        }
        else {
            TranslateMessage(&msg);
            DispatchMessage(&msg);
        }
    }
    ::ExeUnRegisterClassObject();
    // 删除上面创建的 shell 管理器。
    if (pShellManager != nullptr)
    {
        delete pShellManager;
    }

#if !defined(_AFXDLL) && !defined(_AFX_NO_MFC_CONTROLS_IN_DIALOGS)
    ControlBarCleanUp();
#endif

    // OLE Terminate
    AfxOleTerm(FALSE);

    // 由于对话框已关闭,所以将返回 FALSE 以便退出应用程序,
    //  而不是启动应用程序的消息泵。
    return FALSE;
}

解读

1、调用AfxOleInit初始化OLE,此后才能使用OLE相关的一系列API,在AfxOleInit中会调用CoInitalize
2、稍后需要实现ExeRegisterClassObject,在该函数中注册类工厂,此外,如果应用程序不是以自动化模式启动,需要创建IDispatch接口。
3、实现一个消息循环,手动控制在COM接口的引用计数变为0时退出循环。
4、稍后需要实现ExeUnRegisterClassObject反注册类工厂。
5、最后调用AfxOleTerm清理线程。

写在后面

本文简单介绍了创建MFC项目的过程,对一些关键点进行了解读,为了实现进程外COM组件,我们还需要完成以下工作:
1、编写IDL接口定义文件,生成类库。
2、将接口添加到注册表。
3、在项目中实现COM接口。
4、在项目中实现工厂类并注册。
下一篇文章,将会编写接口定义文件,并将接口添加到注册表。