C - 中如何调用动态链接库DLL

C#中如何调用动态链接库DLL

编程技术 2009-08-06 08:58:48 阅读863 评论0 字号：大中小 动态链接库（也称为DLL，即为“Dynamic Link Library”的缩写）是Microsoft Windows最重要的组成要素之一，打开Windows系统文件夹，你会发现文件夹中有很多DLL文件，Windows就是将一些

主要的系统功能以DLL模块的形式实现。

动态链接库是不能直接执行的，也不能接收消息，它只是一个独立的文件，其中包含能被程序或其它DLL调用来完成一定操作的函数(方法。注：C#中一般称为“方法”)，但这些函数不是执行程序本身的一部分，而是根据进程的需要按需载入，此时才能发挥作用。

DLL只有在应用程序需要时才被系统加载到进程的虚拟空间中，成为调用进程的一部分，此时该DLL也只能被该进程的线程访问，它的句柄可以被调用进程所使用，而调用进程的句柄也可以被该DLL所使用。在内存中，一个DLL只有一个实例，且它的编制与具体的编程语言和编译器都没有关系，所以可以通过DLL来实现混合语言编程。DLL函数中的代码所创建的任何对象（包括变量）都归调

用它的线程或进程所有。

下面列出了当程序使用 DLL 时提供的一些优点：[1]

1) 使用较少的资源

当多个程序使用同一个函数库时，DLL 可以减少在磁盘和物理内存中加载的代码的重复量。这不仅可以大大影响在前台运行的程序，而且可以大大影响其他在 Windows 操作系统上运行的程序。

2) 推广模块式体系结构

DLL 有助于促进模块式程序的开发。这可以帮助您开发要求提供多个语言版本的大型程序或要求具有模块式体系结构的程序。模块式程序的一个示例是具有多个可以在运行时动态加载的模块的计帐程

序。

3) 简化部署和安装

当 DLL 中的函数需要更新或修复时，部署和安装 DLL 不要求重新建立程序与该 DLL 的链接。此外，如果多个程序使用同一个 DLL，那么多个程序都将从该更新或修复中获益。当您使用定期更新

或修复的第三方 DLL 时，此问题可能会更频繁地出现。 每种编程语言调用DLL的方法都不尽相同，在此只对用C#调用DLL的方法进行介绍。首先,您需要了解什么是托管,什么是非托管。一般可以认为：非托管代码主要是基于win 32平台开发的DLL，activeX的组件，托管代码是基于.net平台开发的。如果您想深入了解托管与非托管的关系与区别，及它们的运行机制，请您自行查找资

料，本文件在此不作讨论。

(一) 调用DLL中的非托管函数一般方法

首先，应该在C#语言源程序中声明外部方法，其基本形式是：

[DLLImport(“DLL文件”)]

修饰符 extern 返回变量类型 方法名称 （参数列表）

其中：

DLL文件：包含定义外部方法的库文件。

修饰符： 访问修饰符，除了abstract以外在声明方法时可以使用的

修饰符。

返回变量类型：在DLL文件中你需调用方法的返回变量类型。

方法名称：在DLL文件中你需调用方法的名称。 参数列表：在DLL文件中你需调用方法的列表。

注意：需要在程序声明中使用System.Runtime.InteropServices命名

空间。

DllImport只能放置在方法声明上。

DLL文件必须位于程序当前目录或系统定义的查询路径中（即：系统

环境变量中Path所设置的路径）。

返回变量类型、方法名称、参数列表一定要与DLL文件中的定义相

一致。

若要使用其它函数名，可以使用EntryPoint属性设置，如： [DllImport(\static extern int MsgBox(int hWnd, string msg, string caption, int

type);

其它可选的 DllImportAttribute 属性：

CharSet 指示用在入口点中的字符集，如：CharSet=CharSet.Ansi；

SetLastError 指示方法是否保留 Win32\上一错误\，如：

SetLastError=true；

ExactSpelling 指示 EntryPoint 是否必须与指示的入口点的拼写完

全匹配，如：ExactSpelling=false；

PreserveSig指示方法的签名应当被保留还是被转换， 如：

PreserveSig=true；

CallingConvention指示入口点的调用约定， 如：CallingConvention=CallingConvention.Winapi；

此外，关于“数据封送处理”及“封送数字和逻辑标量”请参阅其它一些

文章[2]。

C#例子：

1. 启动VS.NET，新建一个项目，项目名称为“Tzb”，模板为

“Windows 应用程序”。

2. 在“工具箱”的“ Windows 窗体”项中双击“Button”项，向

“Form1”窗体中添加一个按钮。

3. 改变按钮的属性：Name为 “B1”，Text为 “用DllImport调用DLL弹出提示框”，并将按钮B1调整到适当大小，移到适当位置。 4. 在类视图中双击“Form1”，打开“Form1．cs”代码视图，在

“namespace Tzb”上面输入“using

System.Runtime.InteropServices;”，以导入该命名空间。 5. 在“Form1．cs［设计］”视图中双击按钮B1，在“B1_Click”方

法上面使用关键字 static 和 extern 声明方法“MsgBox”，将 DllImport 属性附加到该方法，这里我们要使用的是“user32．dll”中

的“MessageBoxA”函数，具体代码如下： [DllImport(\static extern int MsgBox(int hWnd, string msg, string caption, int

type);

然后在“B1_Click”方法体内添加如下代码，以调用方法“MsgBox”：

MsgBox(0,\这就是用 DllImport 调用 DLL 弹出的提示框哦！ \

挑战杯 \

6. 按“F5”运行该程序，并点击按钮B1，便弹出如下提示框：

(二) 动态装载、调用DLL中的非托管函数

在上面已经说明了如何用DllImport调用DLL中的非托管函数，但是这个是全局的函数，假若DLL中的非托管函数有一个静态变量S，每次调用这个函数的时候，静态变量S就自动加1。结果，当需要重

新计数时，就不能得出想要的结果。下面将用例子说明：

1. DLL的创建 1) 启动Visual C++ 6.0；

2) 新建一个“Win32 Dynamic-Link Library”工程，工程名称为

“Count”；

3) 在“Dll kind”选择界面中选择“A simple dll project”；

4) 打开Count.cpp，添加如下代码： // 导出函数，使用“ _stdcall ” 标准调用

extern \

int _stdcall count(int init)

{//count 函数，使用参数 init 初始化静态的整形变量 S ，并使 S 自

加 1 后返回该值 static int S=init;

S++; return S;

}

5) 按“F7”进行编译，得到Count.dll（在工程目录下的Debug文

件夹中）。

2. 用DllImport调用DLL中的count函数 1) 打开项目“Tzb”，向“Form1”窗体中添加一个按钮。 2) 改变按钮的属性：Name为 “B2”，Text为 “用DllImport调用DLL中count函数”，并将按钮B1调整到适当大小，移到适当位

置。

3) 打开“Form1．cs”代码视图，使用关键字 static 和 extern 声明方法“count”，并使其具有来自 Count.dll 的导出函数count的实

现，代码如下：

[DllImport(\static extern int count(int init);

4) 在“Form1．cs［设计］”视图中双击按钮B2，在“B2_Click”

方法体内添加如下代码：

MessageBox.Show(\用 DllImport 调用 DLL 中的 count 函数， n 传入的实参为 0 ，得到的结果是： \挑战杯

\

MessageBox.Show(\用 DllImport 调用 DLL 中的 count 函数， n 传入的实参为 10 ，得到的结果是： \结

果可不是想要的 11 哦！！！ \挑战杯 \

MessageBox.Show(\所得结果表明： n 用 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/unload assembly那样，所以只能借助API函数了。在kernel32.dll中，与动态库调用有关的

函数包括[3]：

①LoadLibrary（或MFC 的AfxLoadLibrary），装载动态库。 ②GetProcAddress，获取要引入的函数，将符号名或标识号转换为

DLL内部地址。

③FreeLibrary（或MFC的AfxFreeLibrary），释放动态链接库。

它们的原型分别是：

HMODULE LoadLibrary(LPCTSTR lpFileName); FARPROC GetProcAddress(HMODULE hModule, LPCWSTR

lpProcName);

BOOL FreeLibrary(HMODULE hModule);

现在，我们可以用IntPtr hModule=LoadLibrary(“Count.dll”);来获得Dll的句柄,用IntPtr farProc=GetProcAddress(hModule,”_count@4”);

来获得函数的入口地址。

但是，知道函数的入口地址后，怎样调用这个函数呢？因为在C#中是没有函数指针的，没有像C++那样的函数指针调用方式来调用函数，所以我们得借助其它方法。经过研究，发现我们可以通过结合使用System.Reflection.Emit及System.Reflection.Assembly里的类和函数达到我们的目的。为了以后使用方便及实现代码的复用，我们可

以编写一个类。 1) dld类的编写：

1. 打开项目“Tzb”，打开类视图，右击“Tzb”，选择“添加”-->“类”，类名设置为“dld”，即dynamic loading dll 的每个单词的开头字母。

2. 添加所需的命名空间及声明参数传递方式枚举： using System.Runtime.InteropServices; // 用 DllImport 需用此 命

名空间

using System.Reflection; // 使用 Assembly 类需用此 命名空间 using System.Reflection.Emit; // 使用 ILGenerator 需用此 命名空

间

在“public class dld”上面添加如下代码声明参数传递方式枚

举： ///

{

ByValue = 0x0001, ByRef = 0x0002

}

3. 声明LoadLibrary、GetProcAddress、FreeLibrary及私有变

量hModule和farProc：

///

///

/// 函数库模块的句柄

[DllImport(\

static extern IntPtr LoadLibrary(string lpFileName);

///

///

///

/// 函数指针

[DllImport(\

static extern IntPtr GetProcAddress(IntPtr hModule, string

lpProcName); ///

///

/// 是否已释放指定的 Dll

[DllImport(\

static extern bool FreeLibrary(IntPtr hModule);

///

private IntPtr hModule=IntPtr.Zero;

///

private IntPtr farProc=IntPtr.Zero;

4. 添加LoadDll方法，并为了调用时方便，重载了这个方法：

///

///

public void LoadDll(string lpFileName)

{

hModule=LoadLibrary(lpFileName);

if(hModule==IntPtr.Zero)

throw(new Exception(\没有找到 :\

}

若已有已装载Dll的句柄，可以使用LoadDll方法的第二个版

本：

public void LoadDll(IntPtr HMODULE)

{

if(HMODULE==IntPtr.Zero)

throw(new Exception(\所传入的函数库模块的句柄 HMODULE 为

空 .\

hModule=HMODULE;

}

5. 添加LoadFun方法，并为了调用时方便，也重载了这个方法，

方法的具体代码及注释如下：

///

///

public void LoadFun(string lpProcName) { // 若函数库模块的句柄为空，则抛出异常

if(hModule==IntPtr.Zero)

throw(new Exception(\函数库模块的句柄为空 , 请确保已进行

LoadDll 操作 !\// 取得函数指针

farProc = GetProcAddress(hModule,lpProcName);

// 若函数指针，则抛出异常 if(farProc==IntPtr.Zero)

throw(new Exception(\没有找到 :\这个函数的入

口点 \

}

///

///

/// public void LoadFun(string lpFileName,string lpProcName)

{ // 取得函数库模块的句柄 hModule=LoadLibrary(lpFileName); // 若函数库模块的句柄为空，则抛出异常

if(hModule==IntPtr.Zero)

throw(new Exception(\没有找到 :\

// 取得函数指针

farProc = GetProcAddress(hModule,lpProcName);

// 若函数指针，则抛出异常 if(farProc==IntPtr.Zero)

throw(new Exception(\没有找到 :\这个函数的入

口点 \

}

6. 添加UnLoadDll及Invoke方法，Invoke方法也进行了重载：

///

{

FreeLibrary(hModule); hModule=IntPtr.Zero;

farProc=IntPtr.Zero;

}

本文来源：https://www.bwwdw.com/article/1vpp.html