基於VC++6.0的DLL開發

 
基於VC++6.0的DLL開發
2007-10-24 15:56

基於VC++6.0的DLL開發
文章引用自: [引用] 2006-06-07 | 發表者: 李鴻儒


    
基於VC++6.0的DLL開發
最近在開發一個基於網絡的模塊,目標是將這個在CAsyncSocket基礎上開發的擴展類,進行有效的封裝,嚮應用程序提供模塊化的功能,之間查詢了很多資料。瞭解DLL的開發。

下面是一篇我覺得不錯的文章,我引用在這裏,是向大家起一個拋磚引玉的作用。

總體感覺這篇文章對DLL的整個開發過程都作了比較通俗易懂的描述。

一、前言

  自從微軟推出16位的Windows操作系統起,此後每種版本的Windows操作系統都非常依賴於動態鏈接庫(DLL)中的函數和數據,實際上Windows操作系統中幾乎所有的內容都由DLL以一種或另外一種形式代表着,例如顯示的字體和圖標存儲在GDI DLL中、顯示Windows桌面和處理用戶的輸入所需要的代碼被存儲在一個User DLL中、Windows編程所需要的大量的API函數也被包含在Kernel DLL中。

  在Windows操作系統中使用DLL有很多優點,最主要的一點是多個應用程序、甚至是不同語言編寫的應用程序可以共享一個DLL文件,真正實現了資源"共享",大大縮小了應用程序的執行代碼,更加有效的利用了內存;使用DLL的另一個優點是DLL文件作爲一個單獨的程序模塊,封裝性、獨立性好,在軟件需要升級的時候,開發人員只需要修改相應的DLL文件就可以了,而且,當DLL中的函數改變後,只要不是參數的改變,程序代碼並不需要重新編譯。這在編程時十分有用,大大提高了軟件開發和維護的效率。

  既然DLL那麼重要,所以搞清楚什麼是DLL、如何在Windows操作系統中開發使用DLL是程序開發人員不得不解決的一個問題。本文針對這些問題,通過一個簡單的例子,即在一個DLL中實現比較最大、最小整數這兩個簡單函數,全面地解析了在Visual C++編譯環境下編程實現DLL的過程,文章中所用到的程序代碼在Windows98系統、Visual C++6.0編譯環境下通過。

  二、DLL的概念

  DLL是建立在客戶/服務器通信的概念上,包含若干函數、類或資源的庫文件,函數和數據被存儲在一個DLL(服務器)上並由一個或多個客戶導出而使用,這些客戶可以是應用程序或者是其它的DLL。DLL庫不同於靜態庫,在靜態庫情況下,函數和數據被編譯進一個二進制文件(通常擴展名爲*.LIB),Visual C++的編譯器在處理程序代碼時將從靜態庫中恢復這些函數和數據並把他們和應用程序中的其他模塊組合在一起生成可執行文件。這個過程稱爲"靜態鏈接",此時因爲應用程序所需的全部內容都是從庫中複製了出來,所以靜態庫本身並不需要與可執行文件一起發行。

  在動態庫的情況下,有兩個文件,一個是引入庫(.LIB)文件,一個是DLL文件,引入庫文件包含被DLL導出的函數的名稱和位置,DLL包含實際的函數和數據,應用程序使用LIB文件鏈接到所需要使用的DLL文件,庫中的函數和數據並不複製到可執行文件中,因此在應用程序的可執行文件中,存放的不是被調用的函數代碼,而是DLL中所要調用的函數的內存地址,這樣當一個或多個應用程序運行是再把程序代碼和被調用的函數代碼鏈接起來,從而節省了內存資源。從上面的說明可以看出,DLL和.LIB文件必須隨應用程序一起發行,否則應用程序將會產生錯誤。

  微軟的Visual C++支持三種DLL,它們分別是Non-MFC Dll(非MFC動態庫)、Regular Dll(常規DLL)、Extension Dll(擴展DLL)。
Non-MFC DLL: 指的是不用MFC的類庫結構,直接用C語言寫的DLL,其導出的函數是標準的C接口,能被非MFC或MFC編寫的應用程序所調用。
Regular DLL: 和下述的Extension Dlls一樣,是用MFC類庫編寫的,它的一個明顯的特點是在源文件裏有一個繼承CWinApp的類(注意:此類DLL雖然從CWinApp派生,但沒有消息循環),被導出的函數是C函數、C++類或者C++成員函數(注意不要把術語C++類與MFC的微軟基礎C++類相混淆),調用常規DLL的應用程序不必是MFC應用程序,只要是能調用類C函數的應用程序就可以,它們可以是在Visual C++、Dephi、Visual Basic、Borland C等編譯環境下利用DLL開發應用程序。

   常規DLL又可細分成靜態鏈接到MFC和動態鏈接到MFC上的,這兩種常規DLL的區別將在下面介紹。與常規DLL相比,使用擴展DLL用於導出增強MFC基礎類的函數或子類,用這種類型的動態鏈接庫,可以用來輸出一個從MFC所繼承下來的類。

   擴展DLL:是使用MFC的動態鏈接版本所創建的,並且它只被用MFC類庫所編寫的應用程序所調用。例如你已經創建了一個從MFC的CtoolBar類的派生類用於創建一個新的工具欄,爲了導出這個類,你必須把它放到一個MFC擴展的DLL中。擴展DLL 和常規DLL不一樣,它沒有一個從CWinApp繼承而來的類的對象,所以,開發人員必須在DLL中的DllMain函數添加初始化代碼和結束代碼。

三、動態鏈接庫的創建

  在Visual C++6.0開發環境下,打開FileNewProject選項,可以選擇Win32 Dynamic-Link Library或MFC AppWizard[dll]來以不同的方式來創建Non-MFC Dll、Regular Dll、Extension Dll等不同種類的動態鏈接庫。

  1. Win32 Dynamic-Link Library方式創建Non-MFC DLL動態鏈接庫

  每一個DLL必須有一個入口點,這就象我們用C編寫的應用程序一樣,必須有一個WINMAIN函數一樣。在Non-MFC DLL中DllMain是一個缺省的入口函數,你不需要編寫自己的DLL入口函數,用這個缺省的入口函數就能使動態鏈接庫被調用時得到正確的初始化。如果應用程序的DLL需要分配額外的內存或資源時,或者說需要對每個進程或線程初始化和清除操作時,需要在相應的DLL工程的.CPP文件中對DllMain()函數按照下面的格式書寫。  

 

BOOL APIENTRY DllMain(HANDLE hModule,DWORD ul_reason_for_call,LPVOID lpReserved)
{
   switch( ul_reason_for_call )
     {
       case DLL_PROCESS_ATTACH: .......
       case DLL_THREAD_ATTACH: .......
       case DLL_THREAD_DETACH: .......
       case DLL_PROCESS_DETACH: .......
     }
   return TRUE;
}  

  參數中,hMoudle是動態庫被調用時所傳遞來的一個指向自己的句柄(實際上,它是指向_DGROUP段的一個選擇符);ul_reason_for_call是一個說明動態庫被調原因的標誌,當進程或線程裝入或卸載動態鏈接庫的時候,操作系統調用入口函數,並說明動態鏈接庫被調用的原因,它所有的可能值爲:DLL_PROCESS_ATTACH: 進程被調用、DLL_THREAD_ATTACH: 線程被調用、DLL_PROCESS_DETACH: 進程被停止、DLL_THREAD_DETACH: 線程被停止;lpReserved爲保留參數。到此爲止,DLL的入口函數已經寫了,剩下部分的實現也不難,你可以在DLL工程中加入你所想要輸出的函數或變量了。

  我們已經知道DLL是包含若干個函數的庫文件,應用程序使用DLL中的函數之前,應該先導出這些函數,以便供給應用程序使用。要導出這些函數有兩種方法,一是在定義函數時使用導出關鍵字_declspec(dllexport),另外一種方法是在創建DLL文件時使用模塊定義文件.Def。需要讀者注意的是在使用第一種方法的時候,不能使用DEF文件。下面通過兩個例子來說明如何使用這兩種方法創建DLL文件。

  1)使用導出函數關鍵字_declspec(dllexport)創建MyDll.dll,該動態鏈接庫中有兩個函數,分別用來實現得到兩個數的最大和最小數。在MyDll.h和MyDLL.cpp文件中分別輸入如下原代碼:  

//MyDLL.h
extern "C" _declspec(dllexport) int Max(int a, int b);
extern "C" _declspec(dllexport) int Min(int a, int b);

//MyDll.cpp
#include
#include"MyDll.h"
int Max(int a, int b)
{
    if(a>=b)
     return a;
    else
     return b;
}

int Min(int a, int b)
{
   if(a>=b)
    return b;
   else
    return a;
}  

  該動態鏈接庫編譯成功後,打開MyDll工程中的debug目錄,可以看到MyDll.dll、MyDll.lib兩個文件。LIB文件中包含DLL文件名和DLL文件中的函數名等,該LIB文件只是對應該DLL文件的"映像文件",與DLL文件中,LIB文件的長度要小的多,在進行隱式鏈接DLL時要用到它。讀者可能已經注意到在MyDll.h中有關鍵字"extern C",它可以使其他編程語言訪問你編寫的DLL中的函數。

  2)用.def文件創建工程MyDll

  爲了用.def文件創建DLL,請先刪除上個例子創建的工程中的MyDll.h文件,保留MyDll.cpp並在該文件頭刪除#include MyDll.h語句,同時往該工程中加入一個文本文件,命名爲MyDll.def,再在該文件中加入如下代碼:

LIBRARY MyDll
EXPORTS
Max
Min

  其中LIBRARY語句說明該def文件是屬於相應DLL的,EXPORTS語句下列出要導出的函數名稱。我們可以在.def文件中的導出函數後加@n,如Max@1Min@2,表示要導出的函數順序號,在進行顯式連時可以用到它。該DLL編譯成功後,打開工程中的Debug目錄,同樣也會看到MyDll.dll和MyDll.lib文件。

  2.MFC AppWizard[dll]方式生成常規/擴展DLL

  在MFC AppWizard[dll]下生成DLL文件又有三種方式,在創建DLL是,要根據實際情況選擇創建DLL的方式。一種是常規DLL靜態鏈接到MFC,另一種是常規DLL動態鏈接到MFC。兩者的區別是:前者使用的是MFC的靜態鏈接庫,生成的DLL文件長度大,一般不使用這種方式,後者使用MFC的動態鏈接庫,生成的DLL文件長度小;動態鏈接到MFC的規則DLL所有輸出的函數應該以如下語句開始:    

AFX_MANAGE_STATE(AfxGetStaticModuleState( )) //此語句用來正確地切換MFC模塊狀態  

  最後一種是MFC擴展DLL,這種DLL特點是用來建立MFC的派生類,Dll只被用MFC類庫所編寫的應用程序所調用。前面我們已經介紹過,Extension DLLs 和Regular DLLs不一樣,它沒有一個從CWinApp繼承而來的類的對象,編譯器默認了一個DLL入口函數DLLMain()作爲對DLL的初始化,你可以在此函數中實現初始化,代碼如下:  

BOOL WINAPI APIENTRY DLLMain(HINSTANCE hinstDll,DWORD reason ,LPVOID flmpload)
{
switch(reason)
{
    ……………//初始化代碼;
}
return true;
}  

  參數hinstDll存放DLL的句柄,參數reason指明調用函數的原因,lpReserved是一個被系統所保留的參數。對於隱式鏈接是一個非零值,對於顯式鏈接值是零。

  在MFC下建立DLL文件,會自動生成def文件框架,其它與建立傳統的Non-MFC DLL沒有什麼區別,只要在相應的頭文件寫入關鍵字_declspec(dllexport)函數類型和函數名等,或在生成的def文件中EXPORTS下輸入函數名就可以了。需要注意的是在向其它開發人員分發MFC擴展DLL 時,不要忘記提供描述DLL中類的頭文件以及相應的.LIB文件和DLL本身,此後開發人員就能充分利用你開發的擴展DLL了。

四、動態鏈接庫DLL的鏈接

  應用程序使用DLL可以採用兩種方式:
一種是隱式鏈接,另一種是顯式鏈接。
在使用DLL之前首先要知道DLL中函數的結構信息。Visual C++6.0在VCin目錄下提供了一個名爲Dumpbin.exe的小程序,用它可以查看DLL文件中的函數結構。
Windows系統將遵循下面的搜索順序來定位DLL:
   1.包含EXE文件的目錄,
   2.進程的當前工作目錄,
   3.Windows系統目錄,
   4.Windows目錄,
   5.列在Path環境變量中的一系列目錄。

  1.隱式鏈接

  隱式鏈接就是在程序開始執行時就將DLL文件加載到應用程序當中。實現隱式鏈接很容易,只要將導入函數關鍵字_declspec(dllimport)函數名等寫到應用程序相應的頭文件中就可以了。下面的例子通過隱式鏈接調用MyDll.dll庫中的Min函數。首先生成一個項目爲TestDll,在DllTest.h、DllTest.cpp文件中分別輸入如下代碼:  

 

//Dlltest.h
#pragma comment(lib,"MyDll.lib")
extern "C"_declspec(dllimport) int Max(int a,int b);
extern "C"_declspec(dllimport) int Min(int a,int b);

//TestDll.cpp
#include
#include"Dlltest.h"

void main()
{
int a;
a=min(8,10)
printf("比較的結果爲%d ",a);
}    

  在創建DllTest.exe文件之前,要先將MyDll.dll和MyDll.lib拷貝到當前工程所在的目錄下面,也可以拷貝到windows的System目錄下。如果DLL使用的是def文件,要刪除TestDll.h文件中關鍵字extern "C"。TestDll.h文件中的關鍵字Progam commit是要Visual C+的編譯器在link時,鏈接到MyDll.lib文件,當然,開發人員也可以不使用#pragma comment(lib,"MyDll.lib")語句,而直接在工程的Setting->Link頁的Object/Moduls欄填入MyDll.lib既可。

  2.顯式鏈接

  顯式鏈接是應用程序在執行過程中隨時可以加載DLL文件,也可以隨時卸載DLL文件,這是隱式鏈接所無法作到的,所以顯式鏈接具有更好的靈活性,對於解釋性語言更爲合適。不過實現顯式鏈接要麻煩一些。在應用程序中用LoadLibrary或MFC提供的AfxLoadLibrary顯式的將自己所做的動態鏈接庫調進來,動態鏈接庫的文件名即是上述兩個函數的參數,此後再用GetProcAddress()獲取想要引入的函數。自此,你就可以象使用如同在應用程序自定義的函數一樣來調用此引入函數了。在應用程序退出之前,應該用FreeLibrary或MFC提供的AfxFreeLibrary釋放動態鏈接庫。下面是通過顯式鏈接調用DLL中的Max函數的例子。  

#include  
#include

void main(void)
{
typedef int(*pMax)(int a,int b);
typedef int(*pMin)(int a,int b);
HINSTANCE hDLL;
PMax Max ;
HDLL=LoadLibrary("MyDll.dll");//加載動態鏈接庫MyDll.dll文件;
Max=(pMax)GetProcAddress(hDLL,"Max");
A=Max(5,8);
Printf("比較的結果爲%d ",a);
FreeLibrary(hDLL);//卸載MyDll.dll文件;
}  

  在上例中使用類型定義關鍵字typedef,定義指向和DLL中相同的函數原型指針,然後通過LoadLibray()將DLL加載到當前的應用程序中並返回當前DLL文件的句柄,然後通過GetProcAddress()函數獲取導入到應用程序中的函數指針,函數調用完畢後,使用FreeLibrary()卸載DLL文件。在編譯程序之前,首先要將DLL文件拷貝到工程所在的目錄或Windows系統目錄下。

  使用顯式鏈接應用程序編譯時不需要使用相應的Lib文件。另外,使用GetProcAddress()函數時,可以利用MAKEINTRESOURCE()函數直接使用DLL中函數出現的順序號,如將GetProcAddress(hDLL,"Min")改爲GetProcAddress(hDLL, MAKEINTRESOURCE(2))(函數Min()在DLL中的順序號是2),這樣調用DLL中的函數速度很快,但是要記住函數的使用序號,否則會發生錯誤。


     DLL的顯式鏈接在某些時候比隱式鏈接具有更大的靈活性。比如,如果在運行時發現DLL無法找到,程序可以顯示一個錯誤信息並能繼續運行。當你想爲你的程序提供插件服務時,顯式鏈接也很有用處。

顯式鏈接到全局C/C++函數非常簡單。假設你想調用DLL中的一個函數ExportedFn,你可以像這樣很簡單地導出它:

extern "C" _declspec(dllexport)

void ExportedFn(int Param1, char* param2);

必須使用extern "C"鏈接標記,否則C++編譯器會產生一個修飾過的函數名,這樣導出函數的名字將不再是ExportedFn,而是一個形如"??ExportedFn@QAEX”的名字。假設這個函數從DLL1.dll導出,那麼客戶端可以像這樣調用這個函數:

HMODULE hMod = LoadLibrary("Dll1.dll");

typedef void (*PExportedFn)(int, char*);

PExportedFn pfnEF = (PExportedFn)GetProcAdress("ExportedFn");

pfnEF(1, "SomeString");

如果你想導出並顯式鏈接一組C++成員函數又該怎麼辦呢?這裏有兩個問題。第一是C++成員函數名是經過修飾的(即使指定extern "C"標記也是這樣);第二是C++不允許將指向成員函數的指針轉換成其它類型。這兩個問題限制了C++類的顯式鏈接。下面介紹兩種方法來解決這個問題:①用虛函數表的方法,這也是COM使用的方法;②用GetProcAddress直接調用。我將以下面這個類爲例進行講解:

class A

{

private:

int m_nNum;    

public:   

A();

A(int n);

virtual ~A();

void SetNum(int n);

int GetNum();

};

一.用虛函數表進行顯式鏈接

這個方法是COM的基礎。當我們定義一組虛函數的時候,編譯器會創建一個虛函數表,將各虛函數的地址按聲明的順序放入其中。當一個類對象被創建時,它的前四個字節是一個指針,指向這個虛函數表。如果我們將A的定義修改成這樣:

class A

{

private:

int m_nNum;          

public:         

A();

A(int n);

virtual ~A();

virtual void SetNum(int n);

virtual int GetNum();

};

那麼一個虛函數表將被編譯器創建出來,其中包含三個函數的地址:析構函數,SetNum和GetNum。現在類對象要在dll中創建。既然我們要顯式鏈接,就需要一些全局導出函數來調用operator new以創建對象。因爲A有兩種構造函數,所以我們定義兩個函數CreateObjectofA()和CreateObjectofA1(int)並將其導出。客戶可以這樣來使用類對象:

typedef A* (*PFNCreateA1)();
PFNCreateA1 pfnCreateA1 =
(PFNCreateA1)GetProcAddress(hMod, TEXT("CreateObjectofA1"));
A* a = (pfnCreateA1)();
a->SetNum(1);
_tprintf(TEXT("Value of m_nNum in a is %d
"),a->GetNum());
delete a;
要注意的是CreateObjectofA必須使用operator new來創建對象這樣客戶端纔可以安全地調用operator delete來銷燬對象:

extern "C" __declspec(dllexport) A* CreateObjectofA1()

{

return new A();

}

這個方法的使用得用戶可以很容易地爲你的程序製作插件。它的缺點是創建對象的內存必須在dll中分配。

二.直接使用GetProcAddress進行顯式鏈接

這個方法的關鍵在於將GetProcAddress函數返回的FARPROC類型轉化爲C++中指向成員函數的指針。幸運的是,通過C++的unio和模板機制,這個目標可以很容易地實現。我們要做的只是定義如下的函數:

template<class Src , class Dest>

Dest force_cast(Src src){

union{

   Dest d;

   Src s;

} convertor;

convertor.s = Src;

return convertor.d;

}

上面的函數允許我們在任何類型間進行轉換,比reinterpret_cast更加有效。例如,我們定義一種指針類型:

typedef void (A::*PSetNum)(int);

我們可以將FARPROC類型的指針fp轉化成PSetNum:

PSetNum psn = force_cast<PSetNum>(fp);

找到了將FARPROC轉化成成員函數指針的方法以後,我們要考慮如何將C++成員函數以更加友好的名字導出。這可以通過一個.def文件來實現。

第一步是找到待導出函數經過修飾的函數名,這可以通過查看map file或者彙編代碼來實現。然後在.def文件中指定導出函數的新的函數名:

EXPORTS

ConstructorOfA1 = ??0A@@QAE@XZ         PRIVATE

ConstructorOfA2 = ??0A@@QAE@H@Z        PRIVATE

SetNumOfA        = ?SetNum@A@@UAEXH@Z   PRIVATE

GetNumOfA        = ?GetNum@A@@UAEHXZ    PRIVATE           

DestructorOfA    = ??1A@@UAE@XZ         PRIVATE

下面是調用這些成員函數的方法:

typedef void (A::*PfnConstructorOfA1)();

typedef void (A::*PfnConstructorOfA2)(int);

typedef void (A::*PfnDestructorOfA)();

typedef void (A::*PfnSetNumOfA)(int);

typedef int   (A::*PfnGetNumOfA)();

A* a1 = (A*)_alloca(sizeof(A));


PfnConstructorOfA1 pfnConsA =

      force_cast<PfnConstructorOfA1>(GetProcAddress(hMod, TEXT("ConstructorOfA1")));

(a1->*pfnConsA)();


PfnSetNumOfA pfnSetNumA =

           force_cast<PfnSetNumOfA>(GetProcAddress(hMod, TEXT("SetNumOfA")));

(a1->*pfnSetNumA)(1);

            

PfnGetNumOfA pfnGetNumA =

           force_cast<PfnGetNumOfA>(GetProcAddress(hMod, TEXT("GetNumOfA")));

_tprintf(TEXT("Value of m_nNum in a is %d "),(a1->*pfnGetNumA)());


PfnDestructorOfA pfnDestA =  

           force_cast<PfnDestructorOfA>(GetProcAddress(hMod, TEXT("DestructorOfA")));

(a1->*pfnDestA)();

注意這裏使用了alloca從棧中分配內存,你也可以使用malloc從堆中分配內存。但是不能使用C++的new操作符,因爲能過new來分配內存編譯器會自動插入對constructor的調用。但我們要的是顯式鏈接,所以必須避免這種情況。隨之產生的結果是我們只能顯式地去調用構造函數和析構函數

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章