DLL初學者指南(非MFC)




作者：Notsosuperhero

譯者：小刀人

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

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

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

#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++中這里有兩個方法來導出函數(shù)：

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

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

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

#define DLL_EXPORT

#define DLL_EXPORT

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

現(xiàn)在，你需要寫一個將要稱為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;
        }
            }

            

模塊定義文件（.def）

模塊定義文件是一個有著.def文件擴展名的文本文件。它被用于導出一個DLL的函數(shù)，和__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 節(jié)[據(jù) MSDN]，它告訴人們誰可能使用這個DLL，這個DLL做什么或它為了什么（存在）。再下面的部分標識為‘‘EXPORTS‘‘是另一個必需的部分；這個部分使得該函數(shù)可以被其它應用程序訪問到并且它創(chuàng)建一個導入庫。當你生成這個項目時，不僅是一個.dll文件被創(chuàng)建，而且一個文件擴展名為.lib的導出庫也被創(chuàng)建了。除了前面的部分以外，這里還有其它四個部分標識為：NAME, STACKSIZE, SECTIONS, 和 VERSION。我將不再在本文中涉及這些內(nèi)容，但是如果你在Internet上搜索，我想你將找到一些東西（譯注： MSDN2003上對模板定義文件各部分內(nèi)容有詳盡解釋，請參閱）。另外，一個分號(;)開始一個注解，如同‘‘//‘‘在C++中一樣。

現(xiàn)在你已經(jīng)創(chuàng)建了你的DLL，你需要學習如何在一個應用程序中使用它了。當這個DLL被生成后，它創(chuàng)建了一個.dll文件和一個.lib文件；這兩個都是你需要的。

隱式鏈接

這里有兩個方法來載入一個DLL；一個方法是捷徑另一個則相比要復雜些。捷徑是只鏈接到你.lib 文件并將.dll文件置入你的新項目的路徑中去。因此，創(chuàng)建一個新的空的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的方法是有稍微有點復雜的。你將需要函數(shù)指針和一些Windows函數(shù)。但是，通過這種載入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函數(shù)，當然你現(xiàn)在將只需要其中幾個而已。它也包含了一些將會用到的Windows特定變量。你可以去掉DLL的頭文件（DLL_Tutorial.h）因為－如我前面所說－當你使用這個方法載入DLL時你并不需要它。

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

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

            typedef void (*FunctionFunc)();

            

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

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

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

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

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