AFX_MANAGE_STATE(AfxGetStaticModuleState())语句的作用

最新推荐文章于 2014-05-20 12:43:12 发布

转载最新推荐文章于 2014-05-20 12:43:12 发布 · 784 阅读

文章标签：

#dll #mfc #dialog #exe #module #function

本文介绍了解决DLL资源冲突的方法，特别是在MFC应用程序中如何正确加载DLL中的对话框资源。通过调整资源模块句柄，确保应用程序能准确引用到DLL中的资源。

先看一个例子：

1、创建一个动态链接到MFC DLL的规则DLL，其内部包含一个对话框资源。指定该对话框ID如下：
#define IDD_DLL_DIALOG 2000

2、创建一个基于对话框的mfc应用程序，它包含两个对话框资源，IDD_UI_DIALOG和IDD_EXE_DIALOG。并将后者的ID指定如下：
              #define IDD_EXE_DIALOG 2000
其中前者是这个应用程序的用户界面，单击上面的按钮，将弹出一个对话框。部分代码如下：
// in DLL
void CDLL::ShowDlg(void)
{
       CDialog dlg(IDD_DLL_DIALOG); //打开ID为2000的对话框
       dlg.DoModal();
}
// in EXE
void CEXE::OnButtonClick()
{
       ShowDlg();
}

3、单击按钮，弹出的不是期望的DLL中的对话框IDD_DLL_DIALOG，而是应用程序中的对话框IDD_EXE_DIALOG。

解释：

1、应用程序进程本身及其调用的每个DLL模块都具有一个全局唯一的HINSTANCE句柄，它们代表了EXE或DLL模块在进程虚拟空间中的起始地址。（进程本身的模块句柄一般为0x400000，而DLL模块的缺省句柄为0x10000000。如果程序同时加载了多个DLL，则每个DLL模块都会有不同的HINSTANCE。应用程序在加载DLL时对其进行了重定位）。
2、共享MFC DLL（或MFC扩展DLL）的规则DLL涉及到HINSTANCE句柄问题，HINSTANCE句柄对于加载资源特别重要。EXE和DLL都有其自己的资源，而且这些资源的ID可能重复，如果应用程序与规则DLL共享MFC DLL（或MFC扩展DLL），那么将总是默认使用EXE的资源。
3、因此应用程序需要通过资源模块的切换来找到正确的资源。如果应用程序需要来自于DLL的资源，就应将资源模块句柄指定为DLL的模块句柄；如果需要EXE文件中包含的资源，就应将资源模块句柄指定为EXE的模块句柄。

解决办法：

1、在DLL中改进：

方法1。

// in DLL
void CDLL::ShowDlg(void)
{
       AFX_MANAGE_STATE(AfxGetStaticModuleState());
       CDialog dlg(IDD_DLL_DIALOG); //打开ID为2000的对话框
       dlg.DoModal();
}

注：AFX_MANAGE_STATE(AfxGetStaticModuleState());一定是作为接口函数的第一条语句。
       其功能是在栈上（这意味着其作用域是局部的）创建一个AFX_MODULE_STATE类的实例，并将其指   针pModuleState返回。
       AFX_MODULE_STATE类利用其构造函数和析构函数进行存储模块状态现场及恢复现场的工作。
       该宏用于将pModuleState设置为当前的有效模块状态。当离开该宏的作用域时（也就离开了pModuleState所指栈上对象的作用域），先前的模块状态将由类AFX_MODULE_STATE的析构函数恢复。（即自动恢复）

方法2。

// in DLL
void CDLL::ShowDlg(void)
{
       HINSTANCE save_hInstance = AfxGetResourceHandle();
       AfxSetResourceHandle(theApp.m_hInstance);
       CDialog dlg(IDD_DLL_DIALOG); //打开ID为2000的对话框
       dlg.DoModal();
       AfxSetResourceHandle(save_hInstance);
}

注：AfxGetResourceHandle：获取当前资源模块句柄；AfxSetResourceHandle：设置程序目前要使用的资源模块句柄。
同方法1比较，方法2能够灵活地设置程序的资源模块句柄，而方法1则只能在DLL接口函数退出的时候才会恢复模块句柄。

2、在应用程序中改进：

// in EXE
void CEXE::OnButtonClick()
{
       HINSTANCE exe_hInstance = GetModuleHandle(NULL);
      HINSTANCE dll_hInstance = GetModuleHandle("SharedDll.dll");
      AfxSetResourceHandle(dll_hInstance); //切换状态
       ShowDlg();
      AfxSetResourceHandle(exe_hInstance); //恢复状态
}

注：使用状态切换的情况：当DLL导出函数包含MFC资源、类或者需要创建窗口时。

track: http://tech.163.com/06/0316/10/2CB1FGNG0009159F_4.html

////////////////////////

AFX_MANAGE_STATE(AfxGetStaticModuleState());//用于模块切换时的状态保护，

1.AfxGetStaticModuleState()指向当前模块状态;

2.当前函数调用结束后原模块的状态自动被恢复；

3.用于DLL中所调用MFC函数、类、资源时的模块状态切换

现在刚上班就看看源代码,看到这个玩意儿没见过，就到网上，搜了一下，就搜到了。

AFX_MANAGE_STATE(AfxGetStaticModuleState())

看看这个东东到底是干吗的呢?

摘自MSDN:

By default, MFC uses the resource handle of the main application to load the resource template. If you have an exported function in a DLL, such as one that launches a dialog box in the DLL, this template is actually stored in the DLL module. You need to switch the module state for the correct handle to be used. You can do this by adding the following code to the beginning of the function:

AFX_MANAGE_STATE(AfxGetStaticModuleState( ));

This swaps the current module state with the state returned from AfxGetStaticModuleState until the end of the current scope.
也就是說，並不是每一个dll的输出函数前都要调用它，只有在要輸出對話框等用到資源時要調用！

dll中资源是共享的用了这个函数的防止不同的进程修改资源产生错误!

缺省情况下MFC使用主应用程序的资源句柄来载入资源模板，而DLL中的资源模板是存在于DLL模板中，因此要使用这一语句切换到由AfxGetStaticModuleState返回的正确的模块状态，得到正确的句柄。

----------------------------------------------------------------------------------------------------------------------------------

动态链接到MFC的规则DLL所有输出的函数应该以如下语句开始：

AFX_MANAGE_STATE(AfxGetStaticModuleState( )) //此语句用来正确地切换MFC模块状态。作用在MSDN的解释:
By default, MFC uses the resource handle of the main application to load the resource template. If you have an exported function in a DLL, such as one that launches a dialog box in the DLL, this template is actually stored in the DLL module. You need to switch the module state for the correct handle to be used. You can do this by adding the following code to the beginning of the function:
AFX_MANAGE_STATE(AfxGetStaticModuleState( ));

应用《在Dll中创建对话框并调用》

1、第一步创建一“MFC AppWizard (dll)”工程，接下来选择“Regular Dll using shared MFC DLL”，点击“Finish”。
2、添加一对话框资源到工程中，从菜单中选择Insert->Resource，添加一“Dialog”
选择“New”，至此对话框已添加到DLL工程中。
3、为对话框添加一新类，如：CTest，基类为CDialog。
4、在MFCDLL.cpp中(因创建的工程为MFCDLL)添加接口函数：

extern "C" __declspec(dllexport) void Show()
{
	AFX_MANAGE_STATE(AfxGetStaticModuleState());
	CTest test;
	test.DoModal ();
}

别忘了在文件中添加: #include "Test.h"：），大功告成，编译吧!
5、用VC新建一对话框工程，在一按钮点击事件中添加如下代码：

typedef void (WINAPI * TESTDLL)();


HINSTANCE hmod;
hmod = ::LoadLibrary ("mfcdll.dll");
if(hmod==NULL)
{
	AfxMessageBox("Fail");
}
TESTDLL lpproc;
lpproc = (TESTDLL)GetProcAddress (hmod,"Show");
if(lpproc!=(TESTDLL)NULL)
	(*lpproc)();
FreeLibrary(hmod);

转自:http://blog.163.com/ljm1113@126/blog/static/579844522010818104635766/

http://hi.baidu.com/jk_cau/blog/item/619858355e41048da71e120d.html