VC++动态链接库编程之基础慨念

VC++动态链接库编程之基础慨念2005-10-0209:49作者：宋宝华出处：作者授权转载责任编辑：方舟1.概论先来阐述一下DLL(DynamicLinkableLibrary)的概念，你可以简单的把DLL看成一种仓库，它提供给你一些可以直接拿来用的变量、函数或类。在仓库的发展史上经历了“无库－静态链接库－动态链接库”的时代。静态链接库与动态链接库都是共享代码的方式，如果采用静态链接库，则无论你愿不愿意，lib中的指令都被直接包含在最终生成的EXE文件中了。但是若使用DLL，该DLL不必被包含在最终EXE文件中，EXE文件执行时可以“动态”地引用和卸载这个与EXE独立的DLL文件。静态链接库和动态链接库的另外一个区别在于静态链接库中不能再包含其他的动态链接库或者静态库，而在动态链接库中还可以再包含其他的动态或静态链接库。对动态链接库，我们还需建立如下概念：（1）DLL的编制与具体的编程语言及编译器无关只要遵循约定的DLL接口规范和调用方式，用各种语言编写的DLL都可以相互调用。譬如Windows提供的系统DLL（其中包括了Windows的API），在任何开发环境中都能被调用，不在乎其是VisualBasic、VisualC++还是Delphi。（2）动态链接库随处可见我们在Windows目录下的system32文件夹中会看到kernel32.dll、user32.dll和gdi32.dll，windows的大多数API都包含在这些DLL中。kernel32.dll中的函数主要处理内存管理和进程调度；user32.dll中的函数主要控制用户界面；gdi32.dll中的函数则负责图形方面的操作。一般的程序员都用过类似MessageBox的函数，其实它就包含在user32.dll这个动态链接库中。由此可见DLL对我们来说其实并不陌生。(3)VC动态链接库的分类VisualC++支持三种DLL，它们分别是Non-MFCDLL（非MFC动态库）、MFCRegularDLL（MFC规则DLL）、MFCExtensionDLL（MFC扩展DLL）。非MFC动态库不采用MFC类库结构，其导出函数为标准的C接口，能被非MFC或MFC编写的应用程序所调用；MFC规则DLL包含一个继承自CWinApp的类，但其无消息循环；MFC扩展DLL采用MFC的动态链接版本创建，它只能被用MFC类库所编写的应用程序所调用。由于本文篇幅较长，内容较多，势必需要先对阅读本文的有关事项进行说明，下面以问答形式给出。问：本文主要讲解什么内容？答：本文详细介绍了DLL编程的方方面面，努力学完本文应可以对DLL有较全面的掌握，并能编写大多数DLL程序。问：如何看本文？答：本文每一个主题的讲解都附带了源代码例程，可以随文下载（每个工程都经WINRAR压缩）。所有这些例程都由笔者编写并在VC++6.0中调试通过。当然看懂本文不是读者的最终目的，读者应亲自动手实践才能真正掌握DLL的奥妙。问：学习本文需要什么样的基础知识？答：如果你掌握了C，并大致掌握了C++，了解一点MFC的知识，就可以轻松地看懂本文。2.静态链接库对静态链接库的讲解不是本文的重点，但是在具体讲解DLL之前，通过一个静态链接库的例子可以快速地帮助我们建立“库”的概念。图1建立一个静态链接库如图1，在VC++6.0中new一个名称为libTest的staticlibrary工程（单击此处下载本工程），并新建lib.h和lib.cpp两个文件，lib.h和lib.cpp的源代码如下：//文件：lib.h#ifndefLIB_H#defineLIB_HexternCintadd(intx,inty);//声明为C编译、连接方式的外部函数#endif//文件：lib.cpp#includelib.hintadd(intx,inty){returnx+y;}编译这个工程就得到了一个.lib文件，这个文件就是一个函数库，它提供了add的功能。将头文件和.lib文件提交给用户后，用户就可以直接使用其中的add函数了。标准TurboC2.0中的C库函数（我们用来的scanf、printf、memcpy、strcpy等）就来自这种静态库。下面来看看怎么使用这个库，在libTest工程所在的工作区内new一个libCall工程。libCall工程仅包含一个main.cpp文件，它演示了静态链接库的调用方法，其源代码如下：#includestdio.h#include..\lib.h#pragmacomment(lib,..\\debug\\libTest.lib)//指定与静态库一起连接intmain(intargc,char*argv[]){printf(2+3=%d,add(2,3));}静态链接库的调用就是这么简单，或许我们每天都在用，可是我们没有明白这个概念。代码中#pragmacomment(lib,..\\debug\\libTest.lib)的意思是指本文件生成的.obj文件应与libTest.lib一起连接。如果不用#pragmacomment指定，则可以直接在VC++中设置，如图2，依次选择tools、options、directories、libraryfiles菜单或选项，填入库文件路径。图2中加红圈的部分为我们添加的libTest.lib文件的路径。图2在VC中设置库文件路径这个静态链接库的例子至少让我们明白了库函数是怎么回事，它们是哪来的。我们现在有下列模糊认识了：（1）库不是个怪物，编写库的程序和编写一般的程序区别不大，只是库不能单独执行；（2）库提供一些可以给别的程序调用的东东，别的程序要调用它必须以某种方式指明它要调用之。以上从静态链接库分析而得到的对库的懵懂概念可以直接引申到动态链接库中，动态链接库与静态链接库在编写和调用上的不同体现在库的外部接口定义及调用方式略有差异。3.库的调试与查看在具体进入各类DLL的详细阐述之前，有必要对库文件的调试与查看方法进行一下介绍，因为从下一节开始我们将面对大量的例子工程。由于库文件不能单独执行，因而在按下F5（开始debug模式执行）或CTRL+F5（运行）执行时，其弹出如图3所示的对话框，要求用户输入可执行文件的路径来启动库函数的执行。这个时候我们输入要调用该库的EXE文件的路径就可以对库进行调试了，其调试技巧与一般应用工程的调试一样。图3库的调试与“运行”通常有比上述做法更好的调试途径，那就是将库工程和应用工程（调用库的工程）放置在同一VC工作区，只对应用工程进行调试，在应用工程调用库中函数的语句处设置断点，执行后按下F11，这样就单步进入了库中的函数。第2节中的libTest和libCall工程就放在了同一工作区，其工程结构如图4所示。图4把库工程和调用库的工程放入同一工作区进行调试上述调试方法对静态链接库和动态链接库而言是一致的。所以本文提供下载的所有源代码中都包含了库工程和调用库的工程，这二者都被包含在一个工作区内，这是笔者提供这种打包下载的用意所在。动态链接库中的导出接口可以使用VisualC++的Depends工具进行查看，让我们用Depends打开系统目录中的user32.dll，看到了吧？红圈内的就是几个版本的MessageBox了！原来它真的在这里啊，原来它就在这里啊！图5用Depends查看DLL当然Depends工具也可以显示DLL的层次结构，若用它打开一个可执行文件则可以看出这个可执行文件调用了哪些DLL。好，让我们正式进入动态链接库的世界，先来看看最一般的DLL，即非MFCDLL。VC++动态链接库编程之非MFCDLL2005-10-0809:49作者：宋宝华出处：作者授权转载责任编辑：方舟4.1一个简单的DLL第2节给出了以静态链接库方式提供add函数接口的方法，接下来我们来看看怎样用动态链接库实现一个同样功能的add函数。如图6，在VC++中new一个Win32Dynamic-LinkLibrary工程dllTest（单击此处下载本工程）。注意不要选择MFCAppWizard(dll)，因为用MFCAppWizard(dll)建立的将是第5、6节要讲述的MFC动态链接库。图6建立一个非MFCDLL在建立的工程中添加lib.h及lib.cpp文件，源代码如下：/*文件名：lib.h*/#ifndefLIB_H#defineLIB_HexternCint__declspec(dllexport)add(intx,inty);#endif/*文件名：lib.cpp*/#includelib.hintadd(intx,inty){returnx+y;}与第2节对静态链接库的调用相似，我们也建立一个与DLL工程处于同一工作区的应用工程dllCall，它调用DLL中的函数add，其源代码如下：#includestdio.h#includewindows.htypedefint(*lpAddFun)(int,int);//宏定义函数指针类型intmain(intargc,char*argv[]){HINSTANCEhDll;//DLL句柄lpAddFunaddFun;//函数指针hDll=LoadLibrary(..\\Debug\\dllTest.dll);if(hDll!=NULL){addFun=(lpAddFun)GetProcAddress(hDll,add);if(addFun!=NULL){intresult=addFun(2,3);printf(%d,result);}FreeLibrary(hDll);}return0;}分析上述代码，dllTest工程中的lib.cpp文件与第2节静态链接库版本完全相同，不同在于lib.h对函数add的声明前面添加了__declspec(dllexport)语句。这个语句的含义是声明函数add为DLL的导出函数。DLL内的函数分为两种：(1)DLL导出函数，可供应用程序调用；(2)DLL内部函数，只能在DLL程序使用，应用程序无法调用它们。而应用程序对本DLL的调用和对第2节静态链接库的调用却有较大差异，下面我们来逐一分析。首先，语句typedefint(*lpAddFun)(int,int)定义了一个与add函数接受参数类型和返回值均相同的函数指针类型。随后，在main函数中定义了lpAddFun的实例addFun；其次，在函数main中定义了一个DLLHINSTANCE句柄实例hDll，通过Win32Api函数LoadLibrary动态加载了DLL模块并将DLL模块句柄赋给了hDll；再次，在函数main中通过Win32Api函数GetProcAddress得到了所加载DLL模块中函数add的地址并赋给了addFun。经由函数指针addFun进行了对DLL中add函数的调用；最后，应用工程使用完DLL后，在函数main中通过Win32Api函数FreeLibrary释放了已经加载的DLL模块。通过这个简单的例子，我们获知DLL定义和调用的一般概念：(1)DLL中需以某种特定的方式声明导出函数（或变量、类）；(2)应用工程需以某种特定的方式调用DLL的导出函数（或变量、类）。下面我们来对“特定的方式进行”阐述。4.2声明导出函数DLL中导出函数的声明有两种方式：一种为4.1节例子中给出的在函数声明中加上__declspec(dllexport)，这里不再举例说明；另外一种方式是采用模块定义(.def)文件声明，.def文件为链接器提供了有关被链接程序的导出、属性及其他方面的信息。下面的代码演示了怎样同.def文件将函数add声明为DLL导出函数（需在dllTest工程中添加lib.def文件）：;lib.def:导出DLL函数[e-mail]文件的规则为：(1)LIBRARY语句说明.def文件相应的DLL；(2)EXPORTS语句后列出要导出函数的名称。可以在.def文件中的导出函数名后加@n，表示要导出