C调用动态链接库学习资料

1、Good is good, but better carries it.精益求精，善益求善。C调用动态链接库-C#程序实现动态调用DLL的研究摘要：在csdn开发高手2004年第03期中的化功大法将DLL嵌入EXE一文，介绍了如何把一个动态链接库作为一个资源嵌入到可执行文件，在可执行文件运行时，自动从资源中释放出来，通过静态加载延迟实现函数的动态加载，程序退出后实现临时文件的自动删除，从而为解决“DLLHell”提供了一种解决方案。这是一个很好的设计思想，而且该作者也用C+实现了，在Internet上也有相似的VB程序，但在某一技术论坛上提起这种设计方法时，有网友提出：“这种方法好是好，但就是

2、启动速度太慢”。这是因为程序启动时实现DLL释放，然后再加载释放出来的DLL，这个过程会耗费一定的时间。鉴于此问题，经过思索，提出另一个设计方案：DLL作为资源文件嵌入程序，但不需进行DLL释放及其重新加载。本文就是对该设计方案的原理分析及使用C#编程来实现该设计方案。关键词：动态调用DLL，嵌入DLL，C#正文：一、DLL与应用程序动态链接库（也称为DLL，即为“DynamicLinkLibrary”的缩写）是MicrosoftWindows最重要的组成要素之一，打开Windows系统文件夹，你会发现文件夹中有很多DLL文件，Windows就是将一些主要的系统功能以DLL模块的形式实现。动态

3、链接库是不能直接执行的，也不能接收消息，它只是一个独立的文件，其中包含能被程序或其它DLL调用来完成一定操作的函数(方法。注：C#中一般称为“方法”)，但这些函数不是执行程序本身的一部分，而是根据进程的需要按需载入，此时才能发挥作用。DLL只有在应用程序需要时才被系统加载到进程的虚拟空间中，成为调用进程的一部分，此时该DLL也只能被该进程的线程访问，它的句柄可以被调用进程所使用，而调用进程的句柄也可以被该DLL所使用。在内存中，一个DLL只有一个实例，且它的编制与具体的编程语言和编译器都没有关系，所以可以通过DLL来实现混合语言编程。DLL函数中的代码所创建的任何对象（包括变量）都归调用它的线

4、程或进程所有。下面列出了当程序使用DLL时提供的一些优点：11)使用较少的资源当多个程序使用同一个函数库时，DLL可以减少在磁盘和物理内存中加载的代码的重复量。这不仅可以大大影响在前台运行的程序，而且可以大大影响其他在Windows操作系统上运行的程序。2)推广模块式体系结构DLL有助于促进模块式程序的开发。这可以帮助您开发要求提供多个语言版本的大型程序或要求具有模块式体系结构的程序。模块式程序的一个示例是具有多个可以在运行时动态加载的模块的计帐程序。3)简化部署和安装当DLL中的函数需要更新或修复时，部署和安装DLL不要求重新建立程序与该DLL的链接。此外，如果多个程序使用同一个DLL，那么

5、多个程序都将从该更新或修复中获益。当您使用定期更新或修复的第三方DLL时，此问题可能会更频繁地出现。二、DLL的调用每种编程语言调用DLL的方法都不尽相同，在此只对用C#调用DLL的方法进行介绍。首先,您需要了解什么是托管,什么是非托管。一般可以认为：非托管代码主要是基于win32平台开发的DLL，activeX的组件，托管代码是基于.net平台开发的。如果您想深入了解托管与非托管的关系与区别，及它们的运行机制，请您自行查找资料，本文件在此不作讨论。(一)调用DLL中的非托管函数一般方法首先，应该在C#语言源程序中声明外部方法，其基本形式是：DLLImport(“DLL文件”)修饰符exter

6、n返回变量类型方法名称（参数列表）其中：DLL文件：包含定义外部方法的库文件。修饰符：访问修饰符，除了abstract以外在声明方法时可以使用的修饰符。返回变量类型：在DLL文件中你需调用方法的返回变量类型。方法名称：在DLL文件中你需调用方法的名称。参数列表：在DLL文件中你需调用方法的列表。注意：需要在程序声明中使用System.Runtime.InteropServices命名空间。DllImport只能放置在方法声明上。DLL文件必须位于程序当前目录或系统定义的查询路径中（即：系统环境变量中Path所设置的路径）。返回变量类型、方法名称、参数列表一定要与DLL文件中的定义相一致。若要使

7、用其它函数名，可以使用EntryPoint属性设置，如：DllImport(user32.dll,EntryPoint=MessageBoxA)staticexternintMsgBox(inthWnd,stringmsg,stringcaption,inttype);其它可选的DllImportAttribute属性：CharSet指示用在入口点中的字符集，如：CharSet=CharSet.Ansi；SetLastError指示方法是否保留Win32上一错误，如：SetLastError=true；ExactSpelling指示EntryPoint是否必须与指示的入口点的拼写完全匹配，如：

8、ExactSpelling=false；PreserveSig指示方法的签名应当被保留还是被转换，如：PreserveSig=true；CallingConvention指示入口点的调用约定，如：CallingConvention=CallingConvention.Winapi；此外，关于“数据封送处理”及“封送数字和逻辑标量”请参阅其它一些文章2。C#例子：1.启动VS.NET，新建一个项目，项目名称为“Tzb”，模板为“Windows应用程序”。2.在“工具箱”的“Windows窗体”项中双击“Button”项，向“Form1”窗体中添加一个按钮。3.改变按钮的属性：Name为“B1”，

9、Text为“用DllImport调用DLL弹出提示框”，并将按钮B1调整到适当大小，移到适当位置。4.在类视图中双击“Form1”，打开“Form1cs”代码视图，在“namespaceTzb”上面输入“usingSystem.Runtime.InteropServices;”，以导入该命名空间。5.在“Form1cs设计”视图中双击按钮B1，在“B1_Click”方法上面使用关键字static和extern声明方法“MsgBox”，将DllImport属性附加到该方法，这里我们要使用的是“user32dll”中的“MessageBoxA”函数，具体代码如下：DllImport(user32.

10、dll,EntryPoint=MessageBoxA)staticexternintMsgBox(inthWnd,stringmsg,stringcaption,inttype);然后在“B1_Click”方法体内添加如下代码，以调用方法“MsgBox”：MsgBox(0,这就是用DllImport调用DLL弹出的提示框哦！,挑战杯,0 x30);6.按“F5”运行该程序，并点击按钮B1，便弹出如下提示框：(二)动态装载、调用DLL中的非托管函数在上面已经说明了如何用DllImport调用DLL中的非托管函数，但是这个是全局的函数，假若DLL中的非托管函数有一个静态变量S，每次调用这个函数的时

11、候，静态变量S就自动加1。结果，当需要重新计数时，就不能得出想要的结果。下面将用例子说明：1.DLL的创建1)启动VisualC+6.0；2)新建一个“Win32Dynamic-LinkLibrary”工程，工程名称为“Count”；3)在“Dllkind”选择界面中选择“Asimpledllproject”；4)打开Count.cpp，添加如下代码：/导出函数，使用“_stdcall”标准调用externC_declspec(dllexport)int_stdcallcount(intinit);int_stdcallcount(intinit)/count函数，使用参数init初始化静态的

12、整形变量S，并使S自加1后返回该值staticintS=init;S+;returnS;5)按“F7”进行编译，得到Count.dll（在工程目录下的Debug文件夹中）。2.用DllImport调用DLL中的count函数1)打开项目“Tzb”，向“Form1”窗体中添加一个按钮。2)改变按钮的属性：Name为“B2”，Text为“用DllImport调用DLL中count函数”，并将按钮B1调整到适当大小，移到适当位置。3)打开“Form1cs”代码视图，使用关键字static和extern声明方法“count”，并使其具有来自Count.dll的导出函数count的实现，代码如下：Dll

13、Import(Count.dll)staticexternintcount(intinit);4)在“Form1cs设计”视图中双击按钮B2，在“B2_Click”方法体内添加如下代码：MessageBox.Show(用DllImport调用DLL中的count函数，n传入的实参为0，得到的结果是：+count(0).ToString(),挑战杯);MessageBox.Show(用DllImport调用DLL中的count函数，n传入的实参为10，得到的结果是：+count(10).ToString()+n结果可不是想要的11哦！,挑战杯);MessageBox.Show(所得结果表明：n用

14、DllImport调用DLL中的非托管n函数是全局的、静态的函数！,挑战杯);5)把Count.dll复制到项目“Tzb”的binDebug文件夹中，按“F5”运行该程序，并点击按钮B2，便弹出如下三个提示框：第1个提示框显示的是调用“count(0)”的结果，第2个提示框显示的是调用“count(10)”的结果，由所得结果可以证明“用DllImport调用DLL中的非托管函数是全局的、静态的函数”。所以，有时候并不能达到我们目的，因此我们需要使用下面所介绍的方法：C#动态调用DLL中的函数。3.C#动态调用DLL中的函数因为C#中使用DllImport是不能像动态load/unloadass

15、embly那样，所以只能借助API函数了。在kernel32.dll中，与动态库调用有关的函数包括3：LoadLibrary（或MFC的AfxLoadLibrary），装载动态库。GetProcAddress，获取要引入的函数，将符号名或标识号转换为DLL内部地址。FreeLibrary（或MFC的AfxFreeLibrary），释放动态链接库。它们的原型分别是：HMODULELoadLibrary(LPCTSTRlpFileName);FARPROCGetProcAddress(HMODULEhModule,LPCWSTRlpProcName);BOOLFreeLibrary(HMODULE

16、hModule);现在，我们可以用IntPtrhModule=LoadLibrary(“Count.dll”);来获得Dll的句柄,用IntPtrfarProc=GetProcAddress(hModule,”_count4”);来获得函数的入口地址。但是，知道函数的入口地址后，怎样调用这个函数呢？因为在C#中是没有函数指针的，没有像C+那样的函数指针调用方式来调用函数，所以我们得借助其它方法。经过研究，发现我们可以通过结合使用System.Reflection.Emit及System.Reflection.Assembly里的类和函数达到我们的目的。为了以后使用方便及实现代码的复用，我们可以

17、编写一个类。1)dld类的编写：1.打开项目“Tzb”，打开类视图，右击“Tzb”，选择“添加”-“类”，类名设置为“dld”，即dynamicloadingdll的每个单词的开头字母。2.添加所需的命名空间及声明参数传递方式枚举：usingSystem.Runtime.InteropServices;/用DllImport需用此命名空间usingSystem.Reflection;/使用Assembly类需用此命名空间usingSystem.Reflection.Emit;/使用ILGenerator需用此命名空间在“publicclassdld”上面添加如下代码声明参数传递方式枚举：/参数

18、传递方式枚举,ByValue表示值传递,ByRef表示址传递/publicenumModePassByValue=0 x0001,ByRef=0 x00023.声明LoadLibrary、GetProcAddress、FreeLibrary及私有变量hModule和farProc：/原型是:HMODULELoadLibrary(LPCTSTRlpFileName);/DLL文件名/函数库模块的句柄DllImport(kernel32.dll)staticexternIntPtrLoadLibrary(stringlpFileName);/原型是:FARPROCGetProcAddress(HM

19、ODULEhModule,LPCWSTRlpProcName);/包含需调用函数的函数库模块的句柄/调用函数的名称/函数指针DllImport(kernel32.dll)staticexternIntPtrGetProcAddress(IntPtrhModule,stringlpProcName);/原型是:BOOLFreeLibrary(HMODULEhModule);/需释放的函数库模块的句柄/是否已释放指定的DllDllImport(kernel32,EntryPoint=FreeLibrary,SetLastError=true)staticexternboolFreeLibrary(

20、IntPtrhModule);/Loadlibrary返回的函数库模块的句柄/privateIntPtrhModule=IntPtr.Zero;/GetProcAddress返回的函数指针/privateIntPtrfarProc=IntPtr.Zero;4.添加LoadDll方法，并为了调用时方便，重载了这个方法：/装载Dll/DLL文件名publicvoidLoadDll(stringlpFileName)hModule=LoadLibrary(lpFileName);if(hModule=IntPtr.Zero)throw(newException(没有找到:+lpFileName+.)

21、;若已有已装载Dll的句柄，可以使用LoadDll方法的第二个版本：publicvoidLoadDll(IntPtrHMODULE)if(HMODULE=IntPtr.Zero)throw(newException(所传入的函数库模块的句柄HMODULE为空.);hModule=HMODULE;5.添加LoadFun方法，并为了调用时方便，也重载了这个方法，方法的具体代码及注释如下：/获得函数指针/调用函数的名称publicvoidLoadFun(stringlpProcName)/若函数库模块的句柄为空，则抛出异常if(hModule=IntPtr.Zero)throw(newExcepti

22、on(函数库模块的句柄为空,请确保已进行LoadDll操作!);/取得函数指针farProc=GetProcAddress(hModule,lpProcName);/若函数指针，则抛出异常if(farProc=IntPtr.Zero)throw(newException(没有找到:+lpProcName+这个函数的入口点);/获得函数指针/包含需调用函数的DLL文件名/调用函数的名称publicvoidLoadFun(stringlpFileName,stringlpProcName)/取得函数库模块的句柄hModule=LoadLibrary(lpFileName);/若函数库模块的句柄为空

23、，则抛出异常if(hModule=IntPtr.Zero)throw(newException(没有找到:+lpFileName+.);/取得函数指针farProc=GetProcAddress(hModule,lpProcName);/若函数指针，则抛出异常if(farProc=IntPtr.Zero)throw(newException(没有找到:+lpProcName+这个函数的入口点);6.添加UnLoadDll及Invoke方法，Invoke方法也进行了重载：/卸载Dll/publicvoidUnLoadDll()FreeLibrary(hModule);hModule=IntPtr

24、.Zero;farProc=IntPtr.Zero;Invoke方法的第一个版本：/调用所设定的函数/实参/实参类型/实参传送方式/返回类型/返回所调用函数的objectpublicobjectInvoke(objectObjArray_Parameter,TypeTypeArray_ParameterType,ModePassModePassArray_Parameter,TypeType_Return)/下面3个if是进行安全检查,若不能通过,则抛出异常if(hModule=IntPtr.Zero)throw(newException(函数库模块的句柄为空,请确保已进行LoadDll操作!

25、);if(farProc=IntPtr.Zero)throw(newException(函数指针为空,请确保已进行LoadFun操作!);if(ObjArray_Parameter.Length!=ModePassArray_Parameter.Length)throw(newException(参数个数及其传递方式的个数不匹配.);/下面是创建MyAssemblyName对象并设置其Name属性AssemblyNameMyAssemblyName=newAssemblyName();MyAssemblyName.Name=InvokeFun;/生成单模块配件AssemblyBuilderMy

26、AssemblyBuilder=AppDomain.CurrentDomain.DefineDynamicAssembly(MyAssemblyName,AssemblyBuilderAccess.Run);ModuleBuilderMyModuleBuilder=MyAssemblyBuilder.DefineDynamicModule(InvokeDll);/定义要调用的方法,方法名为“MyFun”，返回类型是“Type_Return”参数类型是“TypeArray_ParameterType”MethodBuilderMyMethodBuilder=MyModuleBuilder.Def

27、ineGlobalMethod(MyFun,MethodAttributes.Public|MethodAttributes.Static,Type_Return,TypeArray_ParameterType);/获取一个ILGenerator，用于发送所需的ILILGeneratorIL=MyMethodBuilder.GetILGenerator();inti;for(i=0;iObjArray_Parameter.Length;i+)/用循环将参数依次压入堆栈switch(ModePassArray_Parameteri)caseModePass.ByValue:IL.Emit(OpC

28、odes.Ldarg,i);break;caseModePass.ByRef:IL.Emit(OpCodes.Ldarga,i);break;default:throw(newException(第+(i+1).ToString()+个参数没有给定正确的传递方式.);if(IntPtr.Size=4)/判断处理器类型IL.Emit(OpCodes.Ldc_I4,farProc.ToInt32();elseif(IntPtr.Size=8)IL.Emit(OpCodes.Ldc_I8,farProc.ToInt64();elsethrownewPlatformNotSupportedExcept

29、ion();IL.EmitCalli(OpCodes.Calli,CallingConvention.StdCall,Type_Return,TypeArray_ParameterType);IL.Emit(OpCodes.Ret);/返回值MyModuleBuilder.CreateGlobalFunctions();/取得方法信息MethodInfoMyMethodInfo=MyModuleBuilder.GetMethod(MyFun);returnMyMethodInfo.Invoke(null,ObjArray_Parameter);/调用方法，并返回其值Invoke方法的第二个版本

30、，它是调用了第一个版本的：/调用所设定的函数/函数指针/实参/实参类型/实参传送方式/返回类型/返回所调用函数的objectpublicobjectInvoke(IntPtrIntPtr_Function,objectObjArray_Parameter,TypeTypeArray_ParameterType,ModePassModePassArray_Parameter,TypeType_Return)/下面2个if是进行安全检查,若不能通过,则抛出异常if(hModule=IntPtr.Zero)throw(newException(函数库模块的句柄为空,请确保已进行LoadDll操作!)

31、;if(IntPtr_Function=IntPtr.Zero)throw(newException(函数指针IntPtr_Function为空!);farProc=IntPtr_Function;returnInvoke(ObjArray_Parameter,TypeArray_ParameterType,ModePassArray_Parameter,Type_Return);2)dld类的使用：1打开项目“Tzb”，向“Form1”窗体中添加三个按钮。Name和Text属性分别为“B3”、“用LoadLibrary方法装载Count.dll”，“B4”、“调用count方法”，“B5”、

32、“卸载Count.dll”，并调整到适当的大小及位置。2在“Form1cs设计”视图中双击按钮B3，在“B3_Click”方法体上面添加代码，创建一个dld类实例：/创建一个dld类对象/privatedldmyfun=newdld();3在“B3_Click”方法体内添加如下代码：myfun.LoadDll(Count.dll);/加载Count.dllmyfun.LoadFun(_count4);/调入函数count,_count4是它的入口，可通过Depends查看4“Form1cs设计”视图中双击按钮B4，在“B4_Click”方法体内添加如下代码：objectParameters=n

33、ewobject(int)0;/实参为0TypeParameterTypes=newTypetypeof(int);/实参类型为intModePassthemode=newModePassModePass.ByValue;/传送方式为值传TypeType_Return=typeof(int);/返回类型为int/弹出提示框，显示调用myfun.Invoke方法的结果，即调用count函数MessageBox.Show(这是您装载该Dll后第+myfun.Invoke(Parameters,ParameterTypes,themode,Type_Return).ToString()+次点击此按钮

34、。,挑战杯);5“Form1cs设计”视图中双击按钮B5，在“B5_Click”方法体内添加如下代码：myfun.UnLoadDll();6按“F5”运行该程序，并先点击按钮B3以加载“Count.dll”，接着点击按钮B4三次以调用3次“count(0)”，先后弹出的提示框如下：这三个提示框所得出的结果说明了静态变量S经初始化后，再传入实参“0”也不会改变其值为“0”。7点击按钮B5以卸载“Count.dll”，再点击按钮B3进行装载“Count.dll”，再点击按钮B4查看调用了“count(0)”的结果：从弹出的提示框所显示的结果可以看到又开始重新计数了，也就是实现了DLL的动态装载与卸

35、载了。(三)调用托管DLL一般方法C#调用托管DLL是很简单的，只要在“解决方案资源管理器”中的需要调用DLL的项目下用鼠标右击“引用”，并选择“添加引用”，然后选择已列出的DLL或通过浏览来选择DLL文件，最后需要用using导入相关的命名空间。(四)动态调用托管DLLC#动态调用托管DLL也需要借助System.Reflection.Assembly里的类和方法，主要使用了Assembly.LoadFrom。现在，用例子说明：首先，启动VS.NET，新建一个VisualC#项目，使用的模板为“类库”，名称为“CsCount”，并在类“Class1”中添加静态整型变量S及方法count：/由

36、于static不能修饰方法体内的变量，所以需放在这里，且初始化值为int.MinValuestaticintS=int.MinValue;publicintcount(intinit)/判断S是否等于int.MinValue，是的话把init赋值给Sif(S=int.MinValue)S=init;S+;/S自增1returnS;/返回S然后，打开项目“Tzb”，向“Form1”窗体中添加一个按钮，Name属性为“B6”，Text属性为“用Assembly类来动态调用托管DLL”，调整到适当大小和位置，双击按钮B6，转入代码视图，先导入命名空间：usingSystem.Reflection;接

37、着添加Invoke方法和B6_Click方法代码：privateobjectInvoke(stringlpFileName,stringNamespace,stringClassName,stringlpProcName,objectObjArray_Parameter)Try/载入程序集AssemblyMyAssembly=Assembly.LoadFrom(lpFileName);Typetype=MyAssembly.GetTypes();foreach(Typetintype)/查找要调用的命名空间及类if(t.Namespace=Namespace&t.Name=ClassName)

38、/查找要调用的方法并进行调用MethodInfom=t.GetMethod(lpProcName);if(m!=null)objecto=Activator.CreateInstance(t);returnm.Invoke(o,ObjArray_Parameter);elseMessageBox.Show(装载出错!);/trycatch(System.NullReferenceExceptione)MessageBox.Show(e.Message);/catchreturn(object)0;/Invoke“B6_Click”方法体内代码如下：/显示count(0)返回的值MessageB

39、ox.Show(这是您第+Invoke(CsCount.dll,CsCount,Class1,count,newobject(int)0).ToString()+次点击此按钮。,挑战杯);最后，把项目“CsCount”的binDebug文件夹中的CsCount.dll复制到项目“Tzb”的binDebug文件夹中，按“F5”运行该程序，并点击按钮B6三次，将会弹出3个提示框，内容分别是“这是您第1次点击此按钮。”、“这是您第2次点击此按钮。”、“这是您第3次点击此按钮。”，由此知道了静态变量S在这里的作用。(五)C#程序嵌入DLL的调用DLL文件作为资源嵌入在C#程序中，我们只要读取该资源文件

40、并以“byte”返回，然后就用“AssemblyLoad(byte);”得到DLL中的程序集，最后就可以像上面的Invoke方法那样对DLL中的方法进行调用。当然不用上面方法也可以，如用接口实现动态调用，但DLL中必须有该接口的定义并且程序中也要有该接口的定义；也可用反射发送实现动态调用4。现在我只对像上面的Invoke方法那样对DLL中的方法进行调用进行讨论，为了以后使用方便及实现代码的复用，我们可以结合上一个编写一个类。1)ldfs类的编写：在项目“Tzb”中新建一个名为ldfs的类，意为“loaddllfromresource”，请注意，在这个类中“resource”不只是嵌入在EXE程

41、序中的资源，它也可以是硬盘上任意一个DLL文件，这是因为ldfs的类中的方法LoadDll有些特别，就是先从程序的内嵌的资源中查找需加载的DLL，如果找不到，就查找硬盘上的。首先导入所需的命名空间：usingSystem.IO;/对文件的读写需要用到此命名空间usingSystem.Reflection;/使用Assembly类需用此命名空间usingSystem.Reflection.Emit;/使用ILGenerator需用此命名空间声明一静态变量MyAssembly：/记录要导入的程序集staticAssemblyMyAssembly;添加LoadDll方法：privatebyteLoa

42、dDll(stringlpFileName)AssemblyNowAssembly=Assembly.GetEntryAssembly();Streamfs=null;try/尝试读取资源中的DLLfs=NowAssembly.GetManifestResourceStream(NowAssembly.GetName().Name+.+lpFileName);finally/如果资源没有所需的DLL，就查看硬盘上有没有，有的话就读取if(fs=null&!File.Exists(lpFileName)throw(newException(找不到文件:+lpFileName);elseif(fs

43、=null&File.Exists(lpFileName)FileStreamFs=newFileStream(lpFileName,FileMode.Open);fs=(Stream)Fs;bytebuffer=newbyte(int)fs.Length;fs.Read(buffer,0,buffer.Length);fs.Close();returnbuffer;/以byte返回读到的DLL添加UnLoadDll方法来卸载DLL：publicvoidUnLoadDll()/使MyAssembly指空MyAssembly=null;添加Invoke方法来进行对DLL中方法的调用，其原理大体上

44、和“Form1cs”中的方法Invoke相同，不过这里用的是“Assembly.Load”，而且用了静态变量MyAssembly来保存已加载的DLL，如果已加载的话就不再加载，如果还没加载或者已加载的不同现在要加载的DLL就进行加载，其代码如下所示：publicobjectInvoke(stringlpFileName,stringNamespace,stringClassName,stringlpProcName,objectObjArray_Parameter)try/判断MyAssembly是否为空或MyAssembly的命名空间不等于要调用方法的命名空间，如果条件为真，就用Assembly.Load加载所需DLL作为程序集if(MyAssembly=null|MyAssembly.GetName().Name!=Namespace)MyAssembly=Assembly.Loa