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 initializationif ( !AfxWinInit (hInstance, hPrevInstance, lpCmdLine, nCmdShow))goto InitFailure;// App global initializations (rare)if (pApp != NULL && !pApp->InitApplication())goto InitFailure;// Perform specific initializationsif (!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 callsif (AfxGetModuleThreadState()->m_nTempMapLock != 0){TRACE(traceAppMsg, 0, "Warning\n", AfxGetModuleThreadState ()->m_nTempMapLock);}AfxLockTempMaps ();AfxUnlockTempMaps (-1);#endifAfxWinTerm();return nReturnCode;}

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

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

CWinThread* AFXAPI AfxGetThread()
{// check for current thread in module thread stateAFX_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深度学习时代、智能机器时代，我不知道未来还会有什么时代，只记得这一路走来，充满着艰辛与收获，愿同大家一起走下去，充满希望的走下去。