DLL初學者指南(非MFC)

作者：Notsosuperhero

譯者：小刀人

環境： Visual C++ 2003, Windows
源代碼下載：DLL_Project.rar -DLL Project的源代碼及測試項目
原文出處： codeguru

我正在學習DLLs，談不上對其有什麼高屋建瓴的見解;本文只是（通過）編碼讓你看到並想知道代碼是如何運行的。在本文中，我假定你知道如何使用你的編譯器特性，比如設置目錄路徑等等。

爲了建立項目，請選擇Win32 控制檯項目（Win32 Console Application），並且在應用程序設置標籤（the advanced tab）上，選擇DLL和空項目選項。DLLs可能並不如你想像的那樣難。首先寫你的頭文件（header file）；稱爲DLLTutorial.h。這個文件與其它頭文件一樣，其中只是一些函數的原型。

#ifndef _DLL_TUTORIAL_H_
#define _DLL_TUTORIAL_H_
#include <iostream>
#if defined DLL_EXPORT
#define DECLDIR __declspec(dllexport)
#else
#define DECLDIR __declspec(dllimport)
#endif

 

extern "C"
{
DECLDIR int Add( int a, int b );
DECLDIR void Function( void );
}
#endif

前面兩行指示編譯器只包含這個文件一次。extern "C"告訴編譯器該部分可以在C/C++中使用。

在VC++中這裏有兩個方法來導出函數：

     1、使用__declspec，一個Microsoft定義的關鍵字。

     2、創建一個模塊定義文件(Module-Definition File即.DEF)。第一種方法稍稍比第二種方法簡單些，但兩種都工作得很好。

__declspec(dllexport)導出函數符號到在你的DLL中的一個存儲類。當下面一行被定義時我定義DECLDIR來運行這個函數，

#define DLL_EXPORT

同時也導入函數如果下面一行

#define DLL_EXPORT

沒有在源文件中出現。在此情況下，你將導出函數Add（int a, int b)和Function()。

現在，你需要寫一個將要稱爲DLLTutorial.cpp的源文件。

#include <iostream>
#include "DLL_Tutorial.h"

 

#define DLL_EXPORT extern "C"
{
DECLDIR int Add( int a, int b )
{
return( a + b );
} DECLDIR void Function( void )
{
std::cout << "DLL Called!" << std::endl;
} }

這裏你定義了（DLL中的）所有函數。Int Add(int a, int b)只簡單地將兩個數相加而void Function(void)只是在你的DLL被調用時（將信息）通知你。在我像你展示如何使用DLL前，我想告訴你一些關於模塊定義文件（.def）的內容。

模塊定義文件（.def）

模塊定義文件是一個有着.def文件擴展名的文本文件。它被用於導出一個DLL的函數，和__declspec(dllexport)很相似，但是.def文件並不是Microsoft定義的。一個.def文件中只有兩個必需的部分：LIBRARY 和 EXPORTS。讓我們先看一個基本的.def文件稍後我將解析之。

LIBRARY dll_tutorial
DESCRIPTION "our simple DLL"
EXPORTS
        Add @1
        Function @2
        

第一行，''LIBRARY''是一個必需的部分。它告訴鏈接器（linker）如何命名你的DLL。下面被標識爲''DESCRIPTION''的部分並不是必需的，但是我喜歡把它放進去。該語句將字符串寫入 .rdata 節[據 MSDN]，它告訴人們誰可能使用這個DLL，這個DLL做什麼或它爲了什麼（存在）。再下面的部分標識爲''EXPORTS''是另一個必需的部分；這個部分使得該函數可以被其它應用程序訪問到並且它創建一個導入庫。當你生成這個項目時，不僅是一個.dll文件被創建，而且一個文件擴展名爲.lib的導出庫也被創建了。除了前面的部分以外，這裏還有其它四個部分標識爲：NAME, STACKSIZE, SECTIONS, 和 VERSION。我將不再在本文中涉及這些內容，但是如果你在Internet上搜索，我想你將找到一些東西（譯註： MSDN2003上對模板定義文件各部分內容有詳盡解釋，請參閱）。另外，一個分號(;)開始一個註解，如同''//''在C++中一樣。

現在你已經創建了你的DLL，你需要學習如何在一個應用程序中使用它了。當這個DLL被生成後，它創建了一個.dll文件和一個.lib文件；這兩個都是你需要的。

隱式鏈接

這裏有兩個方法來載入一個DLL；一個方法是捷徑另一個則相比要複雜些。捷徑是隻鏈接到你.lib 文件並將.dll文件置入你的新項目的路徑中去。因此，創建一個新的空的Win32控制檯項目並添加一個源文件。將你做的DLL放入你的新項目相同的目錄下。

 

#include <iostream>
#include <DLLTutorial.h>

 

int main()
{
Function();
std::cout << Add(32, 58) << "/n";
return(1);
}

你必需要鏈接到DLLTutorial.lib文件。我在項目屬性中設置了，但是你可能會用下面的語句代替：

#pragma comment(lib, "DLLTutorial.lib") 

請注意我讓編譯器來查看我的DLL文件夾已獲得.lib文件同時讓它順便看下該目錄中的DLL頭文件。如果你不想這麼做，你可以總是把他們放入你的新項目的目錄中並使用""（引號）而不是<>。這就是載入一個DLL的簡單方法。

顯示鏈接

難點的加載DLL的方法是有稍微有點複雜的。你將需要函數指針和一些Windows函數。但是，通過這種載入DLLs的方法，你不需要DLL的.lib或頭文件，而只需要DLL。下面列出一些代碼，我稍後將解析之。

#include <iostream>
#include <windows.h>

 

typedef int (*AddFunc)(int,int);
typedef void (*FunctionFunc)();

int main()
{
AddFunc _AddFunc;
FunctionFunc _FunctionFunc;
HINSTANCE hInstLibrary = LoadLibrary("DLL_Tutorial.dll"); if (hInstLibrary == NULL)
{
FreeLibrary(hInstLibrary);
}

_AddFunc = (AddFunc)GetProcAddress(hInstLibrary, "Add");
_FunctionFunc = (FunctionFunc)GetProcAddress(hInstLibrary, "Function"); if ((_AddFunc == NULL) || (_FunctionFunc == NULL))
{
FreeLibrary(hInstLibrary);
} std::cout << _AddFunc(23, 43) << std::endl;
_FunctionFunc(); std::cin.get(); FreeLibrary(hInstLibrary); return(1);
}

首先你會注意到：這裏包括進了文件“windows.h”同時移走了“DLL_Tutorial.h”。原因很簡單：因爲windows.h包含了一些Windows函數，當然你現在將只需要其中幾個而已。它也包含了一些將會用到的Windows特定變量。你可以去掉DLL的頭文件（DLL_Tutorial.h）因爲－如我前面所說－當你使用這個方法載入DLL時你並不需要它。

下面你會看到：以下面形式的一小塊古靈精怪的代碼:

typedef int (*AddFunc)(int,int);

typedef void (*FunctionFunc)();

這是函數指針。因爲這是一個關於DLL的自學指南，深入探究函數指針超出了本指南的範圍；因此，現在我們只把它們當作DLL包含的函數的別名。我喜歡在尾部用“Func”命名之。(int,int)部分是這個函數的參數部分，比如，Add函數要獲得兩個整數；因此，你需要它們（譯註：指(int,int)部分）作爲函數指針的參數。Function函數沒有參數，因此你讓它爲空。main()部分中的前面兩行是聲明函數指針以使得你可以認爲它們等同於DLL內部的函數。我只是喜歡預先定義它們。

一個HINSTANCE是一個Windows數據類型：是一個實例的句柄；在此情況下，這個實例將是這個DLL。你可以通過使用函數LoadLibrary()獲得DLL的實例，它獲得一個名稱作爲參數。在調用LoadLibrary函數後，你必需查看一下函數返回是否成功。你可以通過檢查HINSTANCE是否等於NULL（在Windows.h中定義爲0或Windows.h包含的一個頭文件）來查看其是否成功。如果其等於NULL，該句柄將是無效的，並且你必需釋放這個庫。換句話說，你必需釋放DLL獲得的內存。如果函數返回成功，你的HINSTANCE就包含了指向DLL的句柄。

一旦你獲得了指向DLL的句柄，你現在可以從DLL中重新獲得函數。爲了這樣作，你必須使用函數GetProcAddress()，它將DLL的句柄（你可以使用HINSTANCE）和函數的名稱作爲參數。你可以讓函數指針獲得由GetProcAddress()返回的值，同時你必需將GetProcAddress()轉換爲那個函數定義的函數指針。舉個例子，對於Add()函數，你必需將GetProcAddress()轉換爲AddFunc；這就是它知道參數及返回值的原因。現在，最好先確定函數指針是否等於NULL以及它們擁有DLL的函數。這只是一個簡單的if語句；如果其中一個等於NULL，你必需如前所述釋放庫。

一旦函數指針擁有DLL的函數，你現在就可以使用它們了，但是這裏有一個需要注意的地方：你不能使用函數的實際名稱；你必需使用函數指針來調用它們。在那以後，所有你需要做的是釋放庫如此而已。

現在你知道了DLL的一些基本知識。你知道如何創建它們，你也知道如何用兩種不同的方法鏈接它們。這裏仍然有更多的東西需要我們學習，但我把它們留給你們自己探索了和更棒的作者來寫了。

作者

我愛彈吉他，我也愛編程。 沒別的了啊，我的生活可“真乏味”，:)