VisualStudio 制作Dynamic Link Library动态链接库文件的详细过程

工具集

如何生成

__declspec(dllexport)

extern “C”

如何使用

声明调用

Example

LoadLibrary

Example

GetProcAddress

Example

FreeLibrary

Example

FAQS

Question 1: GetLastError获取错误代码127

参考案例

工具集

借助工具可以获得Dll库函数的访问地址，以下推荐两款工具以供使用：

Dependency Walker官网

Depends22_x64.zip

Dllexp-x64.zip

如何生成 __declspec(dllexport)

将一个函数声名为导出函数，就是说这个函数要被其他程序调用，即作为DLL的一个对外函数接口。

__declspec(dllexport) RETURN_TYPE FUNCTION() extern “C”

由于在制作DLL导出函数时由于C++存在函数重载

因此__declspec(dllexport) FUNCTION(int,int)在DLL会被decorate，例如: 被decorate成为function_int_int,

而且不同的编译器decorate的方法不同，造成了在用GetProcAddress取得FUNCTION地址时的不便

使用extern "C"时，上述的decorate不会发生，因为C没有函数重载，如此一来被extern"C"修饰的函数，就不具备重载能力。

extern "C" {
  __declspec(dllexport) RETURN_TYPE FUNCTION(){
    ;
  }
}

如何使用

动态载入方式是指在编译之前并不知道将会调用哪些 DLL 函数，完全是在运行过程中根据需要决定应调用哪些函数。

方法是：用 LoadLibrary 函数加载动态链接库到内存，用 GetProcAddress函数动态获得 DLL 函数的入口地址。

当一个 DLL 文件用 LoadLibrary 显式加载后，在任何时刻均可以通过调用 FreeLibrary 函数显式地从内存中把它给卸载。

动态调用使用的 Windows API 函数主要有 3 个，分别是 LoadLibrary、 GetProcAddress 和FreeLibrary

声明调用

注意DLL函数调用约定，必须一致

__stdcall Windows API默认的函数调用协议

__cdecl C/C++默认的函数调用协议

__fastcall 适用于对性能要求较高的场合

Example

假如我有一个函数接口如下：

//@ GETCOMCHECKSUM_API是一个宏定义
//@ #define GETCOMCHECKSUM_API __declspec(dllexport)
GETCOMCHECKSUM_API int fnGetComCheckSum(
                        const unsigned char*  iCsArray,       //[In]数组
                        const unsigned int    iCsSize,        //[In]数值
                        unsigned char&        ioCsValue)      //[In/Out]数值

那么我的调用应该这么写：

//@ __cdecl * 后面函数名可以自定义
typedef int(__cdecl *GetComCheckSum)(
            unsigned char const *,
            unsigned int,
            unsigned char&);

LoadLibrary

[格式] function LoadLibrary(LibFileName : PChar): Thandle;

[功能] 加载由参数 LibFileName 指定的 DLL 文件

[说明] 参数 LibFileName 指定了要装载的 DLL 文件名

如果 LibFileName 没有包含一个路径，系统将按照：当前目录、Windows 目录、Windows 系统目录、包含当前任务可执行文件的目录、列在 PATH 环境变量中的目录等顺序查找文件。

如果函数操作成功，将返回装载 DLL 库模块的实例句柄，否则，将返回一个错误代码，错误代码的定义如下表所示

错误代码含义
0 系统内存不够，可执行文件被破坏或调用非法
2 文件没有被发现
3 路径没有被发现
5 企图动态链接一个任务错误或者有一个共享或网络保护错误
6 库需要为每个任务建立分离的数据段
8 没有足够的内存启动应用程序
10 Windows 版本不正确
11 可执行文件非法或不是Windows 应用程序，或在. EXE映像中有错误
12 应用程序为一个不同的操作系统设计（如 OS/2）
13 应用程序为 MS DOS 4. 0 设计
14 可执行文件的类型不知道
15 试图装载一个实模式应用程序（为早期Windows 版本设计）
16 试图装载包含可写的多个数据段的可执行文件的第二个实例
19 试图装载一个压缩的可执行文件（文件必须被解压后才能被装载）
20 DLL 文件非法
21 应用程序需要 32 位扩展

Example

//@ 定义句柄
HINSTANCE hSnKLib;
//@ 获取链接库句柄       Getchecksum为dll的文件名 即 Getchecksum.dll
//@ 系统将会在当前目录下寻找名为Getchecksum.dll的文件
//@ 至于为什么使用_T("") ，_T是一个宏，作用是让你的程序支持Unicode编码，Windows使用两种字符集ANSI和UNICODE
hSnKLib = LoadLibrary(_T("Getchecksum"))
//@ 如果未能成功获取，抛出错误
if (hSnKLib == NULL)
{
    FreeLibrary(hSnKLib);
  printf("LoadLibrary err\n");
  getchar();
  return 1;
}

GetProcAddress

格式：function GetProcAddress(Module:Thandle; ProcName:PChar): TfarProc;

功能: 返回参数 Module 指定的模块中，由参数 ProcName 指定的过程或函数的入口地址

说明: 参数 Module 包含被调用函数的 DLL 句柄，这个值由 LoadLibrary 返回,procName是指向含有函数名的以 nil 结尾的字符串指针，或者可以是函数的次序值.

大多数情况下，用函数名是一种更稳妥的选择。

如果该函数执行成功，则返回 DLL 中由参数 ProcName 指定的过程或函数的入口地址，否则返回 nil 。

Example

//前面我们在头文件中声明了下述函数
typedef int(__cdecl *GetComCheckSum)(
            unsigned char const *,
            unsigned int,
            unsigned char&);
//实例化并且获取函数地址
//fnGetComCheckSum为dll export出来的函数名，GetComCheckSum为我们引用时候声明的函数名
//这里做的工作就是将dll中函数与我们声明的联系到一块。
GetComCheckSum getcom = (GetComCheckSum)GetProcAddress(hSnKLib, "fnGetComCheckSum")
if (!getcom)
{
FreeLibrary(hSnKLib);//释放dll文件
//Add your code here
}

FreeLibrary

格式：procedure FreeLibrary(Module: Thandle);

说明：将由参数 Module 指定的 DLL 文件从内存中卸载 1 次。

说明：Module 为 DLL 库的句柄。这个值由 LoadLibrary 返回。由于 DLL 在内存中只装载一次，因此调用 FreeLibrary 首先使 DLL 的引用计数减 1，如果计数减为 0 则卸载该 DLL

注意：每调用一次 LoadLibrary 函数就应调用一次 FreeLibrary 函数，以保证不会有多余的库模块在应用程序结束后仍留在内存中，否则导致内存泄漏。

Example FreeLibrary(hSnKLib); FAQS Question 1: GetLastError获取错误代码127

问题描述：

采用"运行期间动态链接"自己的dll文件

LoadLibrary成功获取dll模块句柄

但是GetProcAddress(hModule, “ExportFunc”)却返回NULL，GetLastError获取错误代码127，意思是“找不到指定程序”

问题定位：

用Depends工具（VS2010默认没有，需另行下载：http://www.dependencywalker.com/），查看dll的导出函数名称。