VC++动态链接库(DLL)编程深入浅出(二)

转自：http://hi.baidu.com/sin30%5Fnet/blog/item/35d5d723ea80d843ad34de03.html

 

5.4 MFC规则DLL的调用

　　笔者编写了如图12的对话框MFC程序（下载本工程附件）来调用5.3节的MFC规则DLL，在这个程序的对话框上点击“调用DLL”按钮时弹出5.3节MFC规则DLL中的对话框。

图12 MFC规则DLL的调用例子

　　下面是“调用DLL”按钮单击事件的消息处理函数：

void CRegularDllCallDlg::OnCalldllButton()

{

typedef void (*lpFun)(void);


HINSTANCE hDll; //DLL句柄

hDll = LoadLibrary("RegularDll.dll");

if (NULL==hDll)

{

MessageBox("DLL加载失败");

}



lpFun addFun; //函数指针

lpFun pShowDlg = (lpFun)GetProcAddress(hDll,"ShowDlg");

if (NULL==pShowDlg)

{

MessageBox("DLL中函数寻找失败");

}

pShowDlg();

}

　　上述例子中给出的是显示调用的方式，可以看出，其调用方式与第4节中非MFC DLL的调用方式没有什么不同。

我们照样可以在EXE程序中隐式调用MFC规则DLL，只需要将DLL工程生成的.lib文件和.dll文件拷入当前工程所在的目录，并在RegularDllCallDlg.cpp文件（图12所示对话框类的实现文件）的顶部添加：

#pragma comment(lib,"RegularDll.lib")

void ShowDlg(void);

　　并将void CRegularDllCallDlg::OnCalldllButton() 改为：

void CRegularDllCallDlg::OnCalldllButton()

{

ShowDlg();

}

　　5.5 共享MFC DLL的规则DLL的模块切换

　　应用程序进程本身及其调用的每个DLL模块都具有一个全局唯一的HINSTANCE句柄，它们代表了DLL或EXE模块在进程虚拟空间中的起始地址。进程本身的模块句柄一般为0x400000，而DLL模块的缺省句柄为0x10000000。如果程序同时加载了多个DLL，则每个DLL模块都会有不同的HINSTANCE。应用程序在加载DLL时对其进行了重定位。

　　共享MFC DLL（或MFC扩展DLL）的规则DLL涉及到HINSTANCE句柄问题，HINSTANCE句柄对于加载资源特别重要。EXE和DLL都有其自己的资源，而且这些资源的ID可能重复，应用程序需要通过资源模块的切换来找到正确的资源。如果应用程序需要来自于DLL的资源，就应将资源模块句柄指定为DLL的模块句柄；如果需要EXE文件中包含的资源，就应将资源模块句柄指定为EXE的模块句柄。

　　这次我们创建一个动态链接到MFC DLL的规则DLL（下载本工程附件），在其中包含如图13的对话框。

图13 DLL中的对话框

　　另外，在与这个DLL相同的工作区中生成一个基于对话框的MFC程序，其对话框与图12完全一样。但是在此工程中我们另外添加了一个如图14的对话框。

图14 EXE中的对话框

　　图13和图14中的对话框除了caption不同（以示区别）以外，其它的都相同。

尤其值得特别注意，在DLL和EXE中我们对图13和图14的对话框使用了相同的资源ID=2000，在DLL和EXE工程的resource.h中分别有如下的宏：

 

//DLL中对话框的ID

#define IDD_DLL_DIALOG 2000


//EXE中对话框的ID

#define IDD_EXE_DIALOG 2000

　　与5.3节静态链接MFC DLL的规则DLL相同，我们还是在规则DLL中定义接口函数ShowDlg，原型如下：

#include "StdAfx.h"

#include "SharedDll.h"

void ShowDlg(void)

{

CDialog dlg(IDD_DLL_DIALOG); //打开ID为2000的对话框

dlg.DoModal();

}

　　而为应用工程主对话框的“调用DLL”的单击事件添加如下消息处理函数：

void CSharedDllCallDlg::OnCalldllButton()

{

ShowDlg();

}

　　我们以为单击“调用DLL”会弹出如图13所示DLL中的对话框，可是可怕的事情发生了，我们看到是图14所示EXE中的对话框！

　　惊讶？

　　产生这个问题的根源在于应用程序与MFC规则DLL共享MFC DLL（或MFC扩展DLL）的程序总是默认使用EXE的资源，我们必须进行资源模块句柄的切换，其实现方法有三：

　　方法一 在DLL接口函数中使用：

AFX_MANAGE_STATE(AfxGetStaticModuleState());

我们将DLL中的接口函数ShowDlg改为：

void ShowDlg(void)

{

//方法1:在函数开始处变更，在函数结束时恢复

//将AFX_MANAGE_STATE(AfxGetStaticModuleState());作为接口函数的第一//条语句进行模块状态切换

AFX_MANAGE_STATE(AfxGetStaticModuleState());


CDialog dlg(IDD_DLL_DIALOG);//打开ID为2000的对话框

dlg.DoModal();

}

　　这次我们再点击EXE程序中的“调用DLL”按钮，弹出的是DLL中的如图13的对话框！嘿嘿，弹出了正确的对话框资源。

AfxGetStaticModuleState是一个函数，其原型为：

AFX_MODULE_STATE* AFXAPI AfxGetStaticModuleState( );

　　该函数的功能是在栈上（这意味着其作用域是局部的）创建一个AFX_MODULE_STATE类（模块全局数据也就是模块状态）的实例，对其进行设置，并将其指针pModuleState返回。

AFX_MODULE_STATE类的原型如下：

// AFX_MODULE_STATE (global data for a module)

class AFX_MODULE_STATE : public CNoTrackObject

{

public:

#ifdef _AFXDLL

AFX_MODULE_STATE(BOOL bDLL, WNDPROC pfnAfxWndProc, DWORD dwVersion);

AFX_MODULE_STATE(BOOL bDLL, WNDPROC pfnAfxWndProc, DWORD dwVersion,BOOL bSystem);

#else

AFX_MODULE_STATE(BOOL bDLL);

#endif

~AFX_MODULE_STATE();


CWinApp* m_pCurrentWinApp;

HINSTANCE m_hCurrentInstanceHandle;

HINSTANCE m_hCurrentResourceHandle;

LPCTSTR m_lpszCurrentAppName;


… //省略后面的部分

}

　　AFX_MODULE_STATE类利用其构造函数和析构函数进行存储模块状态现场及恢复现场的工作，类似汇编中call指令对pc指针和sp寄存器的保存与恢复、中断服务程序的中断现场压栈与恢复以及操作系统线程调度的任务控制块保存与恢复。

　　许多看似不着边际的知识点居然有惊人的相似！

AFX_MANAGE_STATE是一个宏，其原型为：

AFX_MANAGE_STATE( AFX_MODULE_STATE* pModuleState )

　　该宏用于将pModuleState设置为当前的有效模块状态。当离开该宏的作用域时（也就离开了pModuleState所指向栈上对象的作用域），先前的模块状态将由AFX_MODULE_STATE的析构函数恢复。

　　方法二 在DLL接口函数中使用：

AfxGetResourceHandle();

AfxSetResourceHandle(HINSTANCE xxx);

　　AfxGetResourceHandle用于获取当前资源模块句柄，而AfxSetResourceHandle则用于设置程序目前要使用的资源模块句柄。

　　我们将DLL中的接口函数ShowDlg改为：

void ShowDlg(void)

{

//方法2的状态变更

HINSTANCE save_hInstance = AfxGetResourceHandle();

AfxSetResourceHandle(theApp.m_hInstance);



CDialog dlg(IDD_DLL_DIALOG);//打开ID为2000的对话框

dlg.DoModal();

//方法2的状态还原

AfxSetResourceHandle(save_hInstance);

}

　　通过AfxGetResourceHandle和AfxSetResourceHandle的合理变更，我们能够灵活地设置程序的资源模块句柄，而方法一则只能在DLL接口函数退出的时候才会恢复模块句柄。方法二则不同，如果将ShowDlg改为：

extern CSharedDllApp theApp; //需要声明theApp外部全局变量

void ShowDlg(void)

{

//方法2的状态变更

HINSTANCE save_hInstance = AfxGetResourceHandle();

AfxSetResourceHandle(theApp.m_hInstance);


CDialog dlg(IDD_DLL_DIALOG);//打开ID为2000的对话框

dlg.DoModal();


//方法2的状态还原

AfxSetResourceHandle(save_hInstance);


//使用方法2后在此处再进行操作针对的将是应用程序的资源

CDialog dlg1(IDD_DLL_DIALOG); //打开ID为2000的对话框

dlg1.DoModal();

}

　　在应用程序主对话框的“调用DLL”按钮上点击，将看到两个对话框，相继为DLL中的对话框（图13）和EXE中的对话框（图14）。

方法三 由应用程序自身切换

　　资源模块的切换除了可以由DLL接口函数完成以外，由应用程序自身也能完成（下载本工程附件）。

　　现在我们把DLL中的接口函数改为最简单的：

void ShowDlg(void)

{


CDialog dlg(IDD_DLL_DIALOG); //打开ID为2000的对话框

dlg.DoModal();

}

　　而将应用程序的OnCalldllButton函数改为：

void CSharedDllCallDlg::OnCalldllButton()

{

//方法3：由应用程序本身进行状态切换


//获取EXE模块句柄

HINSTANCE exe_hInstance = GetModuleHandle(NULL);

//或者HINSTANCE exe_hInstance = AfxGetResourceHandle();


//获取DLL模块句柄

HINSTANCE dll_hInstance = GetModuleHandle("SharedDll.dll");


AfxSetResourceHandle(dll_hInstance); //切换状态

ShowDlg(); //此时显示的是DLL的对话框

AfxSetResourceHandle(exe_hInstance); //恢复状态


//资源模块恢复后再调用ShowDlg

ShowDlg(); //此时显示的是EXE的对话框


}

　　方法三中的Win32函数GetModuleHandle可以根据DLL的文件名获取DLL的模块句柄。如果需要得到EXE模块的句柄，则应调用带有Null参数的GetModuleHandle。

　　方法三与方法二的不同在于方法三是在应用程序中利用AfxGetResourceHandle和AfxSetResourceHandle进行资源模块句柄切换的。同样地，在应用程序主对话框的“调用DLL”按钮上点击，也将看到两个对话框，相继为DLL中的对话框（图13）和EXE中的对话框（图14）。

　　在下一节我们将对MFC扩展DLL进行详细分析和实例讲解。

MFC扩展DLL的内涵为MFC的扩展，用户使用MFC扩展DLL就像使用MFC本身的DLL一样。除了可以在MFC扩展DLL的内部使用MFC以外，MFC扩展DLL与应用程序的接口部分也可以是MFC。我们一般使用MFC扩展DLL来包含一些MFC的增强功能，譬如扩展MFC的CStatic、CButton等类使之具备更强大的能力。

　　使用Visual C++向导生产MFC扩展DLL时，MFC向导会自动增加DLL的入口函数DllMain：

extern "C" int APIENTRY
DllMain(HINSTANCE hInstance, DWORD dwReason, LPVOID lpReserved)
{
// Remove this if you use lpReserved
UNREFERENCED_PARAMETER(lpReserved);

if (dwReason == DLL_PROCESS_ATTACH)
{
   TRACE0("MFCEXPENDDLL.DLL Initializing!/n");

   // Extension DLL one-time initialization
   if (!AfxInitExtensionModule(MfcexpenddllDLL, hInstance))
    return 0;

   // Insert this DLL into the resource chain
   // NOTE: If this Extension DLL is being implicitly linked to by
   // an MFC Regular DLL (such as an ActiveX Control)
   // instead of an MFC application, then you will want to
   // remove this line from DllMain and put it in a separate
   // function exported from this Extension DLL. The Regular DLL
   // that uses this Extension DLL should then explicitly call that
   // function to initialize this Extension DLL. Otherwise,
   // the CDynLinkLibrary object will not be attached to the
   // Regular DLL's resource chain, and serious problems will
   // result.

   new CDynLinkLibrary(MfcexpenddllDLL);
}
else if (dwReason == DLL_PROCESS_DETACH)
{
   TRACE0("MFCEXPENDDLL.DLL Terminating!/n");
   // Terminate the library before destructors are called
   AfxTermExtensionModule(MfcexpenddllDLL);
}
return 1;   // ok
}

　　上述代码完成MFC扩展DLL的初始化和终止处理。

　　由于MFC扩展DLL导出函数和变量的方式与其它DLL没有什么区别，我们不再细致讲解。下面直接给出一个MFC扩展DLL的创建及在应用程序中调用它的例子。

6.1 MFC扩展DLL的创建

　　下面我们将在MFC扩展DLL中导出一个按钮类CSXButton（扩展自MFC的CButton类），类CSXButton是一个用以取代 CButton的类，它使你能在同一个按钮上显示位图和文字，而MFC的按钮仅可显示二者之一。类CSXbutton的源代码在Internet上广泛流传，有很好的“群众基础”，因此用这个类来讲解MFC扩展DLL有其特殊的功效。

　　MFC中包含一些宏，这些宏在DLL和调用DLL的应用程序中被以不同的方式展开，这使得在DLL和应用程序中，使用统一的一个宏就可以表示出输出和输入的不同意思：

// for data
#ifndef AFX_DATA_EXPORT
#define AFX_DATA_EXPORT __declspec(dllexport)
#endif
#ifndef AFX_DATA_IMPORT
#define AFX_DATA_IMPORT __declspec(dllimport)
#endif

// for classes
#ifndef AFX_CLASS_EXPORT
#define AFX_CLASS_EXPORT __declspec(dllexport)
#endif
#ifndef AFX_CLASS_IMPORT
#define AFX_CLASS_IMPORT __declspec(dllimport)
#endif

// for global APIs
#ifndef AFX_API_EXPORT
#define AFX_API_EXPORT __declspec(dllexport)
#endif
#ifndef AFX_API_IMPORT
#define AFX_API_IMPORT __declspec(dllimport)
#endif

#ifndef AFX_EXT_DATA
#ifdef _AFXEXT
   #define AFX_EXT_CLASS       AFX_CLASS_EXPORT
   #define AFX_EXT_API         AFX_API_EXPORT
   #define AFX_EXT_DATA        AFX_DATA_EXPORT
   #define AFX_EXT_DATADEF
#else
   #define AFX_EXT_CLASS       AFX_CLASS_IMPORT
   #define AFX_EXT_API         AFX_API_IMPORT
   #define AFX_EXT_DATA        AFX_DATA_IMPORT
   #define AFX_EXT_DATADEF
#endif
#endif

　　导出一个类，直接在类声明头文件中使用AFX_EXT_CLASS即可，以下是导出CSXButton类的例子：

#ifndef _SXBUTTON_H
#define _SXBUTTON_H

#define SXBUTTON_CENTER -1

class AFX_EXT_CLASS CSXButton : public CButton
{
// Construction
public:
CSXButton();

// Attributes
private:
// Positioning
BOOL   m_bUseOffset;    
CPoint   m_pointImage;
CPoint   m_pointText;
int    m_nImageOffsetFromBorder;
int    m_nTextOffsetFromImage;

// Image
HICON   m_hIcon;     
HBITMAP   m_hBitmap;
HBITMAP   m_hBitmapDisabled;
int    m_nImageWidth, m_nImageHeight;

// Color Tab
char   m_bColorTab;    
COLORREF m_crColorTab;

// State
BOOL   m_bDefault;
UINT   m_nOldAction;
UINT   m_nOldState;

// Operations
public:
// Positioning
int   SetImageOffset( int nPixels );
int   SetTextOffset( int nPixels );
CPoint SetImagePos( CPoint p );
CPoint SetTextPos( CPoint p );

// Image
BOOL SetIcon( UINT nID, int nWidth, int nHeight );
BOOL SetBitmap( UINT nID, int nWidth, int nHeight );
BOOL SetMaskedBitmap( UINT nID, int nWidth, int nHeight, COLORREF crTransparentMask );
BOOL HasImage() { return (BOOL)( m_hIcon != 0 | m_hBitmap != 0 ); }

// Color Tab
void SetColorTab(COLORREF crTab);

// State
BOOL SetDefaultButton( BOOL bState = TRUE );
private:
BOOL SetBitmapCommon( UINT nID, int nWidth, int nHeight, COLORREF crTransparentMask, BOOL bUseMask );
void CheckPointForCentering( CPoint &p, int nWidth, int nHeight );
void Redraw();

// Overrides
// ClassWizard generated virtual function overrides
//{{AFX_VIRTUAL(CSXButton)
public:
virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);
//}}AFX_VIRTUAL

// Implementation
public:
virtual ~CSXButton();

// Generated message map functions
protected:
//{{AFX_MSG(CSXButton)
afx_msg LRESULT OnGetText(WPARAM wParam, LPARAM lParam);
//}}AFX_MSG

DECLARE_MESSAGE_MAP()
};

#endif

　　把SXBUTTON.CPP文件直接添加到工程，编译工程，得到“mfcexpenddll.lib”和“mfcexpenddll.dll”两个文件。我们用Visual Studio自带的Depends工具可以查看这个.dll，发现其导出了众多符号（见图15）。

图15 导出类时导出的大量符号 (＋放大该图片)

　　这些都是类的构造函数、析构函数及其它成员函数和变量经编译器处理过的符号，我们直接用__declspec(dllexport)语句声明类就导出了这些符号。

　　如果我们想用.lib文件导出这些符号，是非常困难的，我们需要在工程中生成.map文件，查询.map文件的符号，然后将其一一导出。如图16，打开DLL工程的settings选项，再选择Link，勾选其中的产生MAP文件（Generate mapfile）就可以产生.map文件了。

　　 打开mfcexpenddll工程生成的.map文件，我们发现其中包含了图15中所示的符号（symbol）

0001:00000380 ?HasImage@CSXButton@@QAEHXZ 10001380 f i SXBUTTON.OBJ
0001:000003d0 ??0CSXButton@@QAE@XZ       100013d0 f   SXBUTTON.OBJ
0001:00000500 ??_GCSXButton@@UAEPAXI@Z   10001500 f i SXBUTTON.OBJ
0001:00000570 ??_ECSXButton@@UAEPAXI@Z   10001570 f i SXBUTTON.OBJ
0001:00000630 ??1CSXButton@@UAE@XZ       10001630 f   SXBUTTON.OBJ
0001:00000700 ?_GetBaseMessageMap@CSXButton@@KGPBUAFX_MSGMAP@@XZ 10001700 f   SXBUTTON.OBJ
0001:00000730 ?GetMessageMap@CSXButton@@MBEPBUAFX_MSGMAP@@XZ 10001730 f   SXBUTTON.OBJ
0001:00000770    ?Redraw@CSXButton@@AAEXXZ 10001770 f i SXBUTTON.OBJ
0001:000007d0    ?SetIcon@CSXButton@@QAEHIHH@Z 100017d0 f   SXBUTTON.OBJ
……………………………………………………………………..//省略

图16 产生.map文件 (＋放大该图片)

　　所以，对于MFC扩展DLL，我们不宜以.lib文件导出类。

 

6.2 MFC扩展DLL的调用

　　在DLL所在工作区新增一个dllcall工程，它是一个基于对话框的MFC EXE程序。在其中增加两个按钮SXBUTTON1、SXBUTTON2，并设置其属性为“Owner draw”，如图17。

图17 设置按钮属性为“Owner draw”

　　在工程中添加两个ICON资源：IDI_MSN_ICON（MSN的图标）、IDI_REFBAR_ICON（Windows的系统图标）。

　　修改工程的“calldllDlg.h”头文件为：

#include "../../mfcexpenddll/SXBUTTON.h" //包含dll的导出类头文件
#pragma comment(lib,"mfcexpenddll.lib")    //隐式链接dll
/////////////////////////////////////////////////////////////////////////////
// CCalldllDlg dialog

class CCalldllDlg : public CDialog
{
// Construction
public:
CCalldllDlg(CWnd* pParent = NULL); // standard constructor

// Dialog Data
//{{AFX_DATA(CCalldllDlg)
enum { IDD = IDD_CALLDLL_DIALOG };
//增加与两个按钮对应的成员变量
CSXButton m_button1;  
CSXButton m_button2;
…
}

　　同时，修改“calldllDlg.cpp”文件，使得m_button1、m_button2成员变量与对话框上的按钮控件建立关联：

void CCalldllDlg::DoDataExchange(CDataExchange* pDX)
{
CDialog::DoDataExchange(pDX);
//{{AFX_DATA_MAP(CCalldllDlg)
DDX_Control(pDX, IDC_BUTTON2, m_button2);
DDX_Control(pDX, IDC_BUTTON1, m_button1);
//}}AFX_DATA_MAP
}

　　修改BOOL CCalldllDlg::OnInitDialog()函数，在其中增加对两个按钮设置ICON的代码：

BOOL CCalldllDlg::OnInitDialog()
{
CDialog::OnInitDialog();

// Add "About..." menu item to system menu.

// IDM_ABOUTBOX must be in the system command range.
ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);
ASSERT(IDM_ABOUTBOX < 0xF000);

CMenu* pSysMenu = GetSystemMenu(FALSE);
if (pSysMenu != NULL)
{
   CString strAboutMenu;
   strAboutMenu.LoadString(IDS_ABOUTBOX);
   if (!strAboutMenu.IsEmpty())
   {
    pSysMenu->AppendMenu(MF_SEPARATOR);
    pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu);
   }
}

// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE);    // Set big icon
SetIcon(m_hIcon, FALSE);   // Set small icon

// TODO: Add extra initialization here
m_button1.SetIcon(IDI_MSN_ICON,16,16);
m_button2.SetIcon(IDI_REFBAR_ICON,16,16);

return TRUE; // return TRUE unless you set the focus to a control
}

　　运行程序，将出现如图18的对话框，图形和文字同时出现在按钮上，这说明我们正确地调用了MFC扩展DLL。

图18 DLL扩展的按钮被显示

　　如果我们不修改void CCalldllDlg::DoDataExchange(CDataExchange* pDX)，即不增加下列代码：

DDX_Control(pDX, IDC_BUTTON2, m_button2);
DDX_Control(pDX, IDC_BUTTON1, m_button1);

　　我们也可以在BOOL CCalldllDlg::OnInitDialog()函数中添加如下代码实现m_button1、m_button2与IDC_BUTTON1、IDC_BUTTON2的关联：

m_button1.SubclassDlgItem(IDC_BUTTON1, this);
m_button2.SubclassDlgItem(IDC_BUTTON2, this);

　　但是，DDX_Control与按钮类的SubclassDlgItem成员函数不能同时存在，否则程序会出错。

6.3 总结

　　由以上分析可知，MFC扩展DLL的导出与引用方式与前几节所讲述的方式没有太大的差别，MFC扩展DLL主要强调对MFC进行功能扩展。因此，如果DLL的目标不是增强MFC的功能，其与应用程序的接口也不是MFC，请不要将DLL建立为MFC扩展DLL。