Windows 动态链接库编程

Windows 动态链接库编程  

1、介绍

Windows操作系统是应用最关的操作系统，因此动态链接库也为程序员所熟悉，即使对于普通的使用者来说，很多时候也会碰到.dll结尾的文件，这就是动态链接库文件。Windows下的动态链接库可以通过参考头文件和.lib库文件进行编译，从而使得动态链接库隐式地被使用；也可以使用LoadLibrary、GetProcAddress等函数来显式调用动态链接库。

2、语法、导入导出

在Windows编程中，对于要使用或被使用的函数或者变量，需要使用 __declspec 关键字来声明，以告诉编译器该变量或函数不是普通的变量或函数，而是一个动态链接库的接口属性。

如果定义一个要被其他代码使用的函数，可以写成：
__declspec( dllexport ) int add(int a, int b)；

如果在该代码中，打算使用另外一个程序中的变量，则可以写成：
__declspec( dllimport ) char *name；

动态链接库通常包含一系列供其他程序使用函数，因此 declspec( dllexport ) 语法形式最为常用。如果动态库需要其他程序中的定义的全局变量，则需要在其他程序中使用导出该变量，在动态链接库中则需要使用 extern declspec( dllexport ) 将该变量声明为外部变量以便使用。

3、链接方式

可以以下列两种方式之一链接到（或加载）DLL：

隐式链接
显式链接

隐式链接有时称为静态加载或加载时动态链接。显式链接有时称为动态加载或运行时动态链接。在隐式链接下，使用 DLL 的可执行文件链接到该 DLL 的创建者所提供的导入库（.lib 文件）。使用 DLL 的可执行文件加载时，操作系统加载此 DLL。客户端可执行文件调用 DLL 的导出函数，就好像这些函数包含在可执行文件内一样。

在显式链接下，使用 DLL 的可执行文件必须进行函数调用以显式加载和卸载该 DLL，并访问该 DLL 的导出函数。客户端可执行文件必须通过函数指针调用导出函数。可执行文件对两种链接方法可以使用同一个 DLL。另外，由于一个可执行文件可隐式链接到某个 DLL，而另一个可显式附加到此 DLL，故这些机制不是互斥的。

4、隐式链接

隐式链接动态链接库比较简单，不予详述。

5、显式链接API函数

显式链接主要涉及到3个API函数（ LoadLibrary , GetProcAddress 和 FreeLibrary ），要使用这些函数包含windows.h头文件即可。

（1）HINSTANCE LoadLibrary(LPCSTR lpLibFileName);

该函数用来加载指定动态库文件，并且返回句柄。

参数lpLibFileName为动态链接库的名称。Windows 首先搜索“已知 DLL”，如 Kernel32.dll 和 User32.dll。然后按下列顺序搜索 DLL：

1、当前进程的可执行模块所在的目录。
2、当前目录。
3、Windows 系统目录。GetSystemDirectory 函数检索此目录的路径。
4、Windows 目录。GetWindowsDirectory 函数检索此目录的路径。
5、PATH 环境变量中列出的目录。

（2）FARPROC GetProcAddress (HMODULE hModule, LPCSTR lpProcName);

函数GetProcAddress 用来获取 DLL 导出函数的地址。返回由lpProcName指定的变量或函数指针。

参数hModule为已经加载的动态库文件的句柄。

参数lpProcName为要调用的变量或函数名称。

（3）BOOL FreeLibrary(HMODULE hModule);
从内存中释放hModule所代表的动态链接库。

（4）如果发生错误，可以调用GetLastError()函数或去错误代码。

6、显示链接举例

（1）动态库文件代码：dll_demo.c

#include <stdio.h>

__declspec( dllexport ) int add(int a, int b)
{
printf("calling add\n");
return a + b;
}

该文件中的add()函数计算两个整数之和，并且返回之前打印提示字符串。函数使用 __declspec( dllexport ) 语法来说明函数add(int a, int b)要被导出。

（2）客户端事例代码：main.c

#include <stdio.h>
#include <windows.h>

int main (int argc, char *argv[])
{
int a = 10, b = 20;
int c = 0;
HINSTANCE   hInstLibrary   =   NULL;
int (*add)();

printf ("Load DLL file\n");
if ((hInstLibrary = LoadLibrary(L"dll_demo.dll")) == NULL)
{
   printf ("***LoadLibrary ERROR: %d.\n", GetLastError());
   return 1;
}
if((add = (int (*)())GetProcAddress(hInstLibrary, "add")) == NULL) {
   printf ("***GetProcAddress ERROR: %d.\n", GetLastError());
   return 1;
}

c = add(a, b);
printf("%d + %d = %d\n", a, b, c);

FreeLibrary(hInstLibrary);
return 0;
}

程序利用LoadLibrary函数加载动态链接dll_demo.dll，利用FreeLibrary关闭句柄，利用GetLastError()获取错误代码，利用GetProcAddress定位共享库中的add函数，然后调用该函数执行加法计算，并打印结果。

（3）编译与运行

编译共享库：

在VS.Net中创建一个动态链接库项目，名称为dll_demo，加入文件dll_demo.c，编译后生成dll_demo.dll文件。

编译事例程序：

在VS.Net中创建一个动态链接库项目，名称为dll_main，加入文件main.c，编译后生成dll_main.exe可以执行文件。

运行：

将 dll_demo.dll 和 dll_main.exe 放在同一个目录下，然后双击运行 dll_main.exe。

输出：

Load DLL file
calling add
10 + 20 = 30

7、调用动态链接库中的变量

也可以使用动态链接库中的变量。例如，在动态链接库中定义：

__declspec( dllexport ) int num = 100;

那么可以在事例程序中这样调用：

int *d;
d = (int *)GetProcAddress(hInstLibrary, "num");
printf("num = %d\n", *d);