Visual Studio 2022的MFC框架——AfxWinMain全局对象和InitInstance函数

我是荔园微风，作为一名在IT界整整25年的老兵，今天我们来重新审视一下Visual Studio 2022下开发工具的MFC框架知识。 

在看这篇帖子前，请先看我的另一篇帖子《Visual Studio 2022的MFC框架——应用程序向导》。

当程序调用了CWinApp类的构造函数，并执行了CMfcApp类的构造函数，且产生了theApp 对象之后，接下来就进入 WinMain 函数。根据前面我写的一些MFC帖子所示的代码，可以发现WinMain 函数实际上是通过调用 AfxWinMain函数来完成它的功能的。

Afx前缀的函数代表应用程序框架Application Framework函数。应用程序框架实际上是一套辅助我们生成应用程序的框架模型。该模型把多个类进行了一个有机的集成，可以根据该模型提供的方案来设计我们自己的应用程序。在MFC中，以Afx为前缀的函数都是全局函数，可以在程序的任何地方调用它们。

我们可以采取同样的方式查找定义AfxWinMain 函数的源文件，在搜索到的文件中双击winmain.cpp,并在其中找到 AfxWinMain函数的定义代码。

int AFXAPI AfxWinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,
        _In_ LPTSTR lpCmdLine, int nCmdShow)
{
　　ASSERT (hPrevInstance == NULL);

　　int nReturnCode =-1;

　　CWinThread* pThread = AfxGetThread();
　　CWinApp* pApp AfxGetApp();

　　// AFX internal initialization
　　if ( !AfxWinInit (hInstance, hPrevInstance, lpCmdLine, nCmdShow))
      goto InitFailure;

　　// App global initializations (rare)
　　if (pApp != NULL && !pApp->InitApplication())
　   　goto InitFailure;

   // Perform specific initializations
　　if (!pThread->InitInstance())
   {
   　　if (pThread->m_pMainWnd != NULL)
      {
      　　TRACE(traceAppMsg, 0, "Warning\n");
　　      pThread->m_pMainWnd->Destroywindow();
      }
  　　nReturnCode = pThread->ExitInstance();
  　　goto InitFailure;
　
　　nReturnCode = pThread->Run();

　　InitFailure:
　　#ifdef _DEBUG
　　   // Check for missing AfxLockTempMap calls
　　   if (AfxGetModuleThreadState()->m_nTempMapLock != 0)
      {
        TRACE(traceAppMsg, 0, "Warning\n", 
       AfxGetModuleThreadState ()->m_nTempMapLock);
      }
　　   AfxLockTempMaps ();
　　   AfxUnlockTempMaps (-1);
　　#endif

　　AfxWinTerm();
　　return nReturnCode;
　　}

在上面所示的代码中，AfxWinMain首先调用AfxGetThread函数获得一个CWinThread类型的指针，接着调用 AfxGetApp函数获得一个CWinApp类型的指针。从MFC类库组织结构图中可以知道CWinApp派生于CWinThread。

下面是AfxGetThread函数的源代码，位于thrdcore.cpp文件中。

CWinThread* AFXAPI AfxGetThread()
{
　　// check for current thread in module thread state

   AFX_MODULE_THREAD_STATE* pState = AfxGetModuleThreadState ();
   CWinThread* pThread = pState->m_pCurrentWinThread;
　　return pThread;
}

从上面所示代码中可以发现， AfxGetThread函数返回的就是在 CWinApp构造函数中保存的 this指针。对Mfc程序来说，这个this指针实际上指向的是CMfcApp的全局对象:theApp。

AfxGetApp是一个全局函数，定义于 afxwin1.inl中：

_AFXWIN_INLINE CWinApp* AFXAPI AfxGetApp()

   { return afxCurrentWinApp;}

而afxCurrentWinApp的定义位于 afxwin.h文件中，代码如下：

#define afxCurrentWinApp   　AfxGetModuleState()->m_pCurrentWinApp

结合查看之前关于MFC帖子中所示的CWinApp构造函数代码，就可以知道 AfxGetApp函数返回的是在 CWinApp 构造函数中保存的 this 指针。对Mfc程序来说， 这个 this 指针实际上指向的是 CMfcApp的对象： theApp。也就是说，对Mfc程序来说， pThread和 pApp所指向的都是CMfcApp类的对象，即theApp全对象。

再来说说InitInstance函数，再回到上面所示的 AfxWinMain函数，可以看到在接下来的代码中，pThread和 pApp调用了三个函数，这三个函数就完成了Win32程序所需要的几个步骤：设计窗口类、注册窗口类、创建窗口、显示窗口、更新窗口、消息循环，以及窗口过程函数。pApp首先调用 InitApplication函数，该函数完成MFC内部管理方面的工作。

接着，调用pThread的 InitInstance 函数。在Mfc程序中，可以发现从 CWinApp派生的应用程序类CMfcApp也有一个InitInstance函数，其声明代码如下所示。

virtual BOOL InitInstance();

从其定义可以知道，InitInstance函数是一个虚函数。根据类的多态性原理，可以知道AfxWinMain函数在这里调用的实际上是子类  CMfcApp 的 InitInstance函数。CMfcApp类的 InitInstance函数定义代码如下所示。

BOOL CMfcApp::InitInstance()
{
　　INITCOMMONCONTROLSEX InitCtrls;
　　InitCtrls. dwsize sizeof (InitCtrls);

　　//将它设置为包括所有要在应用程序中使用的
　　//公共控件类

　　InitCtrls. dwICC = ICC_WIN95_CLASSES;
　　InitCommonControlsEx(&InitCtrls);

　　CWinApp::InitInstance();

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

　　AfxEnableControlContainer();

　　EnableTaskbarInteraction (FALSE);

　　SetRegistryKey(_T("应用程序向导生成的本地应用程序")
    LoadStdProfileSettings(4); //加载标准 INI 文件选项（包括 MRU)

    //注册应用程序的文档模板。　　文档模板
　　//将用作文档、框架窗口和视图之间的连接

　　CSingleDocTemplate* pDocTemplate;

　　pDocTemplate = new CSingleDocTemplate(
　　IDR_MAINFRAME,
  　　RUNTIME_CLASS (CMfcDoc),
　  　RUNTIME_CLASS (CMainFrame),　　//主SDI框架窗口
　　  RUNTIME_CLASS (CMfcView));
　　if ( !pDocTemplate)
   　　return FALSE;
　　AddDocTemplate (pDocTemplate);

　　//分析标准shel1命令、DDE、打开文件操作的命令行
    CCommandLineInfo cmdInfo;
　　ParseCommandLine (cmdInfo);

　
　　if ( !ProcessShellCommand (cmdInfo))
　   　return FALSE;
　　
   //唯一的一个窗口已初始化，因此显示它并对其进行更新
    m_pMainWnd->ShowWindow(SW_SHOW);
　　m_pMainWnd->Updatewindow ();
　　return TRUE;
}

这几篇内容涉及的内容有点难，如果大家看不懂，要结合其他VC的资料综合看。

作者简介：荔园微风，1981年生，高级工程师，浙大工学硕士，软件工程项目主管，做过程序员、软件设计师、系统架构师，早期的Windows程序员，Visual Studio忠实用户，C/C++使用者，是一位在计算机界学习、拼搏、奋斗了25年的老将，经历了UNIX时代、桌面WIN32时代、Web应用时代、云计算时代、手机安卓时代、大数据时代、ICT时代、AI深度学习时代、智能机器时代，我不知道未来还会有什么时代，只记得这一路走来，充满着艰辛与收获，愿同大家一起走下去，充满希望的走下去。