VC++動態連接庫(DLL)編程深刻淺出(zz)

時間 2019-11-12

標籤動態連接 dll 編程深刻欄目 C&C++ 简体版

原文原文鏈接

VC++動態連接庫(DLL)編程深刻淺出(zz)

1.概論
　　先來闡述一下DLL(Dynamic Linkable Library)的概念，你能夠簡單的把DLL當作一種倉庫，它提供給你一些能夠直接拿來用的變量、函數或類。在倉庫的發展史上經歷了「無庫－靜態連接庫－動態連接庫」的時代。
　　靜態連接庫與動態連接庫都是共享代碼的方式，若是採用靜態連接庫，則不管你願不肯意，lib中的指令都被直接包含在最終生成的EXE文件中了。可是若使用DLL，該DLL沒必要被包含在最終EXE文件中，EXE文件執行時能夠「動態」地引用和卸載這個與EXE獨立的DLL文件。靜態連接庫和動態連接庫的另一個區別在於靜態連接庫中不能再包含其餘的動態連接庫或者靜態庫，而在動態連接庫中還能夠再包含其餘的動態或靜態連接庫。
　　對動態連接庫，咱們還需創建以下概念：
　　（1）DLL 的編制與具體的編程語言及編譯器無關
　　只要遵循約定的DLL接口規範和調用方式，用各類語言編寫的DLL均可以相互調用。譬如Windows提供的系統DLL（其中包括了Windows的API），在任何開發環境中都能被調用，不在意其是Visual Basic、Visual C++仍是Delphi。
　　（2）動態連接庫隨處可見
　　咱們在Windows目錄下的system32文件夾中會看到kernel32.dll、user32.dll和gdi32.dll，windows的大多數API都包含在這些DLL中。kernel32.dll中的函數主要處理內存管理和進程調度；user32.dll中的函數主要控制用戶界面； gdi32.dll中的函數則負責圖形方面的操做。
　　通常的程序員都用過相似MessageBox的函數，其實它就包含在user32.dll這個動態連接庫中。因而可知DLL對咱們來講其實並不陌生。
　　(3)VC動態連接庫的分類
　　Visual C++支持三種DLL，它們分別是Non-MFC DLL（非MFC動態庫）、MFC Regular DLL（MFC規則DLL）、MFC Extension DLL（MFC擴展DLL）。
　　非MFC動態庫不採用MFC類庫結構，其導出函數爲標準的C接口，能被非MFC或MFC編寫的應用程序所調用；MFC規則DLL 包含一個繼承自CWinApp的類，但其無消息循環；MFC擴展DLL採用MFC的動態連接版本建立，它只能被用MFC類庫所編寫的應用程序所調用。
因爲本文篇幅較長，內容較多，勢必須要先對閱讀本文的有關事項進行說明，下面以問答形式給出。
　　問：本文主要講解什麼內容？
　　答：本文詳細介紹了DLL編程的方方面面，努力學完本文應能夠對DLL有較全面的掌握，並能編寫大多數DLL程序。
　　問：如何看本文？
　　答：本文每個主題的講解都附帶了源代碼例程，能夠隨文下載（每一個工程都經WINRAR壓縮）。全部這些例程都由筆者編寫並在VC++6.0中調試經過。
　　固然看懂本文不是讀者的最終目的，讀者應親自動手實踐才能真正掌握DLL的奧妙。
　　問：學習本文須要什麼樣的基礎知識？
　　答：若是你掌握了C，並大體掌握了C++，瞭解一點MFC的知識，就能夠輕鬆地看懂本文。
2.靜態連接庫
　　對靜態連接庫的講解不是本文的重點，可是在具體講解DLL以前，經過一個靜態連接庫的例子能夠快速地幫助咱們創建「庫」的概念。 html

圖1 創建一個靜態連接庫程序員

　　如圖1，在VC++6.0中new一個名稱爲libTest的static library工程（單擊此處下載本工程附件），並新建lib.h和lib.cpp兩個文件，lib.h和lib.cpp的源代碼以下：編程

//文件：lib.h
#ifndef LIB_H
#define LIB_H
extern "C" int add(int x,int y);　　　//聲明爲C編譯、鏈接方式的外部函數
#endif
//文件：lib.cpp
#include "lib.h"
int add(int x,int y)
{
return x + y;
} windows

　　編譯這個工程就獲得了一個.lib文件，這個文件就是一個函數庫，它提供了add的功能。將頭文件和.lib文件提交給用戶後，用戶就能夠直接使用其中的add函數了。
　　標準Turbo C2.0中的C庫函數（咱們用來的scanf、printf、memcpy、strcpy等）就來自這種靜態庫。網絡

下面來看看怎麼使用這個庫，在libTest工程所在的工做區內new一個libCall工程。libCall工程僅包含一個main.cpp文件，它演示了靜態連接庫的調用方法，其源代碼以下： app

#include <stdio.h>
#include "..\lib.h"
#pragma comment( lib, "..\\debug\\libTest.lib" ) 　//指定與靜態庫一塊兒鏈接
int main(int argc, char* argv[])
{
printf( "2 + 3 = %d", add( 2, 3 ) );
} 框架

　　靜態連接庫的調用就是這麼簡單，或許咱們天天都在用，但是咱們沒有明白這個概念。代碼中#pragma comment( lib , "..\\debug\\libTest.lib" )的意思是指本文件生成的.obj文件應與libTest.lib一塊兒鏈接。
　　若是不用#pragma comment指定，則能夠直接在VC++中設置，如圖2，依次選擇tools、options、directories、library files菜單或選項，填入庫文件路徑。圖2中加紅圈的部分爲咱們添加的libTest.lib文件的路徑。 less

圖2 在VC中設置庫文件路徑 socket

這個靜態連接庫的例子至少讓咱們明白了庫函數是怎麼回事，它們是哪來的。咱們如今有下列模糊認識了：
　　（1）庫不是個怪物，編寫庫的程序和編寫通常的程序區別不大，只是庫不能單獨執行；
　　（2）庫提供一些能夠給別的程序調用的東東，別的程序要調用它必須以某種方式指明它要調用之。
　　以上從靜態連接庫分析而獲得的對庫的懵懂概念能夠直接引伸到動態連接庫中，動態連接庫與靜態連接庫在編寫和調用上的不一樣體如今庫的外部接口定義及調用方式略有差別。
3.庫的調試與查看
　　在具體進入各種DLL的詳細闡述以前，有必要對庫文件的調試與查看方法進行一下介紹，由於從下一節開始咱們將面對大量的例子工程。
　　因爲庫文件不能單獨執行，於是在按下F5（開始debug模式執行）或CTRL+F5（運行）執行時，其彈出如圖3所示的對話框，要求用戶輸入可執行文件的路徑來啓動庫函數的執行。這個時候咱們輸入要調用該庫的EXE文件的路徑就能夠對庫進行調試了，其調試技巧與通常應用工程的調試同樣。編程語言

圖3 庫的調試與「運行」

　　一般有比上述作法更好的調試途徑，那就是將庫工程和應用工程（調用庫的工程）放置在同一VC工做區，只對應用工程進行調試，在應用工程調用庫中函數的語句處設置斷點，執行後按下F11，這樣就單步進入了庫中的函數。第2節中的libTest和libCall工程就放在了同一工做區，其工程結構如圖4所示。

圖4　把庫工程和調用庫的工程放入同一工做區進行調試

上述調試方法對靜態連接庫和動態連接庫而言是一致的。因此本文提供下載的全部源代碼中都包含了庫工程和調用庫的工程，這兩者都被包含在一個工做區內，這是筆者提供這種打包下載的用意所在。
動態連接庫中的導出接口可使用Visual C++的Depends工具進行查看，讓咱們用Depends打開系統目錄中的user32.dll，看到了吧？紅圈內的就是幾個版本的MessageBox了！原來它真的在這裏啊，原來它就在這裏啊！

圖5　用Depends查看DLL

　　固然Depends工具也能夠顯示DLL的層次結構，若用它打開一個可執行文件則能夠看出這個可執行文件調用了哪些DLL。
　　好，讓咱們正式進入動態連接庫的世界，先來看看最通常的DLL，即非MFC DLL(待續...)

上節給你們介紹了靜態連接庫與庫的調試與查看（動態連接庫(DLL)編程深刻淺出(一)），本節主要介紹非MFC DLL。

4.非MFC DLL

4.1一個簡單的DLL

　　第2節給出了以靜態連接庫方式提供add函數接口的方法，接下來咱們來看看怎樣用動態連接庫實現一個一樣功能的add函數。
　　如圖6，在VC++中new一個Win32 Dynamic-Link Library工程dllTest（單擊此處下載本工程附件）。注意不要選擇MFC AppWizard(dll)，由於用MFC AppWizard(dll)創建的將是第五、6節要講述的MFC 動態連接庫。

圖6 創建一個非MFC DLL

　　在創建的工程中添加lib.h及lib.cpp文件，源代碼以下：

/* 文件名：lib.h　*/
#ifndef LIB_H
#define LIB_H
extern "C" int __declspec(dllexport)add(int x, int y);
#endif
/* 文件名：lib.cpp　*/
#include "lib.h"
int add(int x, int y)
{
return x + y;
}

與第2節對靜態連接庫的調用類似，咱們也創建一個與DLL工程處於同一工做區的應用工程dllCall，它調用DLL中的函數add，其源代碼以下：

#include <stdio.h>
#include <windows.h>
typedef int(*lpAddFun)(int, int); //宏定義函數指針類型
int main(int argc, char *argv[])
{
HINSTANCE hDll; //DLL句柄
lpAddFun addFun; //函數指針
hDll = LoadLibrary("..\\Debug\\dllTest.dll");
if (hDll != NULL)
{
addFun = (lpAddFun)GetProcAddress(hDll, "add");
if (addFun != NULL)
{
int result = addFun(2, 3);
printf("%d", result);
}
FreeLibrary(hDll);
}
return 0;
}

　　分析上述代碼，dllTest工程中的lib.cpp文件與第2節靜態連接庫版本徹底相同，不一樣在於lib.h對函數add的聲明前面添加了 __declspec(dllexport)語句。這個語句的含義是聲明函數add爲DLL的導出函數。DLL內的函數分爲兩種：
　　(1)DLL導出函數，可供應用程序調用；
　　(2) DLL內部函數，只能在DLL程序使用，應用程序沒法調用它們。
　　而應用程序對本DLL的調用和對第2節靜態連接庫的調用卻有較大差別，下面咱們來逐一分析。
　　首先，語句typedef int ( * lpAddFun)(int,int)定義了一個與add函數接受參數類型和返回值均相同的函數指針類型。隨後，在main函數中定義了lpAddFun的實例addFun；
　　其次，在函數main中定義了一個DLL HINSTANCE句柄實例hDll，經過Win32 Api函數LoadLibrary動態加載了DLL模塊並將DLL模塊句柄賦給了hDll；
　　再次，在函數main中經過Win32 Api函數GetProcAddress獲得了所加載DLL模塊中函數add的地址並賦給了addFun。經由函數指針addFun進行了對DLL中add函數的調用；
　　最後，應用工程使用完DLL後，在函數main中經過Win32 Api函數FreeLibrary釋放了已經加載的DLL模塊。
　　經過這個簡單的例子，咱們獲知DLL定義和調用的通常概念：
　　(1)DLL中需以某種特定的方式聲明導出函數（或變量、類）；
　　(2)應用工程需以某種特定的方式調用DLL的導出函數（或變量、類）。
　　下面咱們來對「特定的方式進行」闡述。
4.2 聲明導出函數
　　DLL中導出函數的聲明有兩種方式：一種爲4.1節例子中給出的在函數聲明中加上__declspec(dllexport)，這裏再也不舉例說明；另一種方式是採用模塊定義(.def) 文件聲明，.def文件爲連接器提供了有關被連接程序的導出、屬性及其餘方面的信息。
　　下面的代碼演示了怎樣同.def文件將函數add聲明爲DLL導出函數（需在dllTest工程中添加lib.def文件）：

; lib.def : 導出DLL函數
LIBRARY dllTest
EXPORTS
add @ 1

.def文件的規則爲：
　　(1)LIBRARY語句說明.def文件相應的DLL；
　　(2)EXPORTS語句後列出要導出函數的名稱。能夠在.def文件中的導出函數名後加@n，表示要導出函數的序號爲n（在進行函數調用時，這個序號將發揮其做用）；
　　(3).def 文件中的註釋由每一個註釋行開始處的分號 (;) 指定，且註釋不能與語句共享一行。
　　由此能夠看出，例子中lib.def文件的含義爲生成名爲「dllTest」的動態連接庫，導出其中的add函數，並指定add函數的序號爲1。
4.3 DLL的調用方式
　　在4.1節的例子中咱們看到了由「LoadLibrary-GetProcAddress-FreeLibrary」系統Api提供的三位一體「DLL加載-DLL函數地址獲取-DLL釋放」方式，這種調用方式稱爲DLL的動態調用。
　　動態調用方式的特色是徹底由編程者用 API 函數加載和卸載 DLL，程序員能夠決定 DLL 文件什麼時候加載或不加載，顯式連接在運行時決定加載哪一個 DLL 文件。
　　與動態調用方式相對應的就是靜態調用方式，「有動必有靜」，這來源於物質世界的對立統一。「動與靜」，其對立與統一竟無數次在技術領域裏獲得驗證，譬如靜態IP與DHCP、靜態路由與動態路由等。從前文咱們已經知道，庫也分爲靜態庫與動態庫DLL，而想不到，深刻到DLL內部，其調用方式也分爲靜態與動態。「動與靜」，無處不在。《周易》已認識到有動必有靜的動靜平衡觀，《易．繫辭》曰：「動靜有常，剛柔斷矣」。哲學意味着一種廣泛的真理，所以，咱們經常能夠在枯燥的技術領域看到哲學的影子。
　　靜態調用方式的特色是由編譯系統完成對DLL的加載和應用程序結束時 DLL 的卸載。當調用某DLL的應用程序結束時，若系統中還有其它程序使用該 DLL，則Windows對DLL的應用記錄減1，直到全部使用該DLL的程序都結束時才釋放它。靜態調用方式簡單實用，但不如動態調用方式靈活。
　　下面咱們來看看靜態調用的例子（單擊此處下載本工程附件），將編譯dllTest工程所生成的.lib和.dll文件拷入dllCall工程所在的路徑，dllCall執行下列代碼：

#pragma comment(lib,"dllTest.lib")
//.lib文件中僅僅是關於其對應DLL文件中函數的重定位信息
extern "C" __declspec(dllimport) add(int x,int y);
int main(int argc, char* argv[])
{
int result = add(2,3);
printf("%d",result);
return 0;
}

　　由上述代碼能夠看出，靜態調用方式的順利進行須要完成兩個動做：
　　(1)告訴編譯器與DLL相對應的.lib文件所在的路徑及文件名，#pragma comment(lib,"dllTest.lib")就是起這個做用。
　　程序員在創建一個DLL文件時，鏈接器會自動爲其生成一個對應的.lib文件，該文件包含了DLL 導出函數的符號名及序號（並不含有實際的代碼）。在應用程序裏，.lib文件將做爲DLL的替代文件參與編譯。
　　(2)聲明導入函數，extern "C" __declspec(dllimport) add(int x,int y)語句中的__declspec(dllimport)發揮這個做用。
　　靜態調用方式再也不須要使用系統API來加載、卸載DLL以及獲取DLL中導出函數的地址。這是由於，當程序員經過靜態連接方式編譯生成應用程序時，應用程序中調用的與.lib文件中導出符號相匹配的函數符號將進入到生成的EXE 文件中，.lib文件中所包含的與之對應的DLL文件的文件名也被編譯器存儲在 EXE文件內部。當應用程序運行過程當中須要加載DLL文件時，Windows將根據這些信息發現並加載DLL，而後經過符號名實現對DLL 函數的動態連接。這樣，EXE將能直接經過函數名調用DLL的輸出函數，就象調用程序內部的其餘函數同樣。
4.4 DllMain函數
　　Windows在加載DLL的時候，須要一個入口函數，就如同控制檯或DOS程序須要main函數、WIN32程序須要WinMain函數同樣。在前面的例子中，DLL並無提供DllMain函數，應用工程也能成功引用 DLL，這是由於Windows在找不到DllMain的時候，系統會從其它運行庫中引入一個不作任何操做的缺省DllMain函數版本，並不意味着 DLL能夠放棄DllMain函數。
　　根據編寫規範，Windows必須查找並執行DLL裏的DllMain函數做爲加載DLL的依據，它使得DLL得以保留在內存裏。這個函數並不屬於導出函數，而是DLL的內部函數。這意味着不能直接在應用工程中引用DllMain函數，DllMain是自動被調用的。
　　咱們來看一個DllMain函數的例子（單擊此處下載本工程附件）。

BOOL APIENTRY DllMain( HANDLE hModule,
DWORD ul_reason_for_call,
LPVOID lpReserved
)
{
switch (ul_reason_for_call)
{
case DLL_PROCESS_ATTACH:
printf("\nprocess attach of dll");
break;
case DLL_THREAD_ATTACH:
printf("\nthread attach of dll");
break;
case DLL_THREAD_DETACH:
printf("\nthread detach of dll");
break;
case DLL_PROCESS_DETACH:
printf("\nprocess detach of dll");
break;
}
return TRUE;
}

　　DllMain函數在DLL被加載和卸載時被調用，在單個線程啓動和終止時，DLLMain函數也被調用，ul_reason_for_call指明瞭被調用的緣由。緣由共有4種，即PROCESS_ATTACH、PROCESS_DETACH、THREAD_ATTACH和 THREAD_DETACH，以switch語句列出。
來仔細解讀一下DllMain的函數頭BOOL APIENTRY DllMain( HANDLE hModule, WORD ul_reason_for_call, LPVOID lpReserved )。
　　APIENTRY被定義爲__stdcall，它意味着這個函數以標準Pascal的方式進行調用，也就是WINAPI方式；
　　進程中的每一個DLL模塊被全局惟一的32字節的HINSTANCE句柄標識，只有在特定的進程內部有效，句柄表明了DLL模塊在進程虛擬空間中的起始地址。在Win32中，HINSTANCE和HMODULE的值是相同的，這兩種類型能夠替換使用，這就是函數參數hModule的來歷。
　　執行下列代碼：

hDll = LoadLibrary("..\\Debug\\dllTest.dll");
if (hDll != NULL)
{
addFun = (lpAddFun)GetProcAddress(hDll, MAKEINTRESOURCE(1));
//MAKEINTRESOURCE直接使用導出文件中的序號
if (addFun != NULL)
{
int result = addFun(2, 3);
printf("\ncall add in dll:%d", result);
}
FreeLibrary(hDll);
}

　　咱們看到輸出順序爲：
　　process attach of dll
　　call add in dll:5
　　process detach of dll
　　這一輸出順序驗證了DllMain被調用的時機。
　　代碼中的GetProcAddress ( hDll, MAKEINTRESOURCE ( 1 ) )值得留意，它直接經過.def文件中爲add函數指定的順序號訪問add函數，具體體如今MAKEINTRESOURCE ( 1 )，MAKEINTRESOURCE是一個經過序號獲取函數名的宏，定義爲（節選自winuser.h）：

#define MAKEINTRESOURCEA(i) (LPSTR)((DWORD)((WORD)(i)))
#define MAKEINTRESOURCEW(i) (LPWSTR)((DWORD)((WORD)(i)))
#ifdef UNICODE
#define MAKEINTRESOURCE MAKEINTRESOURCEW
#else
#define MAKEINTRESOURCE MAKEINTRESOURCEA

4.5 __stdcall約定
　　若是經過VC++編寫的DLL欲被其餘語言編寫的程序調用，應將函數的調用方式聲明爲__stdcall方式，WINAPI都採用這種方式，而C/C++缺省的調用方式卻爲__cdecl。__stdcall方式與 __cdecl對函數名最終生成符號的方式不一樣。若採用C編譯方式(在C++中需將函數聲明爲extern "C")，__stdcall調用約定在輸出函數名前面加下劃線，後面加「@」符號和參數的字節數，形如_functionname@number；而 __cdecl調用約定僅在輸出函數名前面加下劃線，形如_functionname。
　　Windows編程中常見的幾種函數類型聲明宏都是與__stdcall和__cdecl有關的（節選自windef.h）：

#define CALLBACK __stdcall //這就是傳說中的回調函數
#define WINAPI __stdcall //這就是傳說中的WINAPI
#define WINAPIV __cdecl
#define APIENTRY WINAPI //DllMain的入口就在這裏
#define APIPRIVATE __stdcall
#define PASCAL __stdcall

　　在lib.h中，應這樣聲明add函數：

int __stdcall add(int x, int y);

　　在應用工程中函數指針類型應定義爲：

typedef int(__stdcall *lpAddFun)(int, int);

　　若在lib.h中將函數聲明爲__stdcall調用，而應用工程中仍使用typedef int (* lpAddFun)(int,int)，運行時將發生錯誤（由於類型不匹配，在應用工程中仍然是缺省的__cdecl調用），彈出如圖7所示的對話框。

圖7 調用約定不匹配時的運行錯誤

圖8中的那段話實際上已經給出了錯誤的緣由，即「This is usually a result of　…」。
　　單擊此處下載__stdcall調用例子工程源代碼附件。
4.6 DLL導出變量
　　DLL定義的全局變量能夠被調用進程訪問；DLL也能夠訪問調用進程的全局數據，咱們來看看在應用工程中引用DLL中變量的例子（單擊此處下載本工程附件）。

/* 文件名：lib.h　*/
#ifndef LIB_H
#define LIB_H
extern int dllGlobalVar;
#endif
/* 文件名：lib.cpp */
#include "lib.h"
#include <windows.h>
int dllGlobalVar;
BOOL APIENTRY DllMain(HANDLE hModule, DWORD ul_reason_for_call, LPVOID lpReserved)
{
switch (ul_reason_for_call)
{
case DLL_PROCESS_ATTACH:
dllGlobalVar = 100; //在dll被加載時，賦全局變量爲100
break;
case DLL_THREAD_ATTACH:
case DLL_THREAD_DETACH:
case DLL_PROCESS_DETACH:
break;
}
return TRUE;
}
;文件名：lib.def
;在DLL中導出變量
LIBRARY "dllTest"
EXPORTS
dllGlobalVar CONSTANT
;或dllGlobalVar DATA
GetGlobalVar

　　從lib.h和lib.cpp中能夠看出，全局變量在DLL中的定義和使用方法與通常的程序設計是同樣的。若要導出某全局變量，咱們須要在.def文件的EXPORTS後添加：

變量名　CONSTANT　　　//過期的方法

　　或

變量名　DATA　　　　//VC++提示的新方法

在主函數中引用DLL中定義的全局變量：

#include <stdio.h>
#pragma comment(lib,"dllTest.lib")
extern int dllGlobalVar;
int main(int argc, char *argv[])
{
printf("%d ", *(int*)dllGlobalVar);
*(int*)dllGlobalVar = 1;
printf("%d ", *(int*)dllGlobalVar);
return 0;
}

　　特別要注意的是用extern int dllGlobalVar聲明所導入的並非DLL中全局變量自己，而是其地址，應用程序必須經過強制指針轉換來使用DLL中的全局變量。這一點，從* (int*)dllGlobalVar能夠看出。所以在採用這種方式引用DLL全局變量時，千萬不要進行這樣的賦值操做：

dllGlobalVar = 1;

　　其結果是dllGlobalVar指針的內容發生變化，程序中之後再也引用不到DLL中的全局變量了。
　　在應用工程中引用DLL中全局變量的一個更好方法是：

#include <stdio.h>
#pragma comment(lib,"dllTest.lib")
extern int _declspec(dllimport) dllGlobalVar; //用_declspec(dllimport)導入
int main(int argc, char *argv[])
{
printf("%d ", dllGlobalVar);
dllGlobalVar = 1; //這裏就能夠直接使用, 無須進行強制指針轉換
printf("%d ", dllGlobalVar);
return 0;
}

　　經過_declspec(dllimport)方式導入的就是DLL中全局變量自己而再也不是其地址了，筆者建議在一切可能的狀況下都使用這種方式。
4.7 DLL導出類

　　DLL中定義的類能夠在應用工程中使用。
　　下面的例子裏，咱們在DLL中定義了point和circle兩個類，並在應用工程中引用了它們（單擊此處下載本工程附件）。

//文件名：point.h，point類的聲明
#ifndef POINT_H
#define POINT_H
#ifdef DLL_FILE
class _declspec(dllexport) point //導出類point
#else
class _declspec(dllimport) point //導入類point
#endif
{
public:
float y;
float x;
point();
point(float x_coordinate, float y_coordinate);
};
#endif
//文件名：point.cpp，point類的實現
#ifndef DLL_FILE
#define DLL_FILE
#endif
#include "point.h"
//類point的缺省構造函數
point::point()
{
x = 0.0;
y = 0.0;
}
//類point的構造函數
point::point(float x_coordinate, float y_coordinate)
{
x = x_coordinate;
y = y_coordinate;
}
//文件名：circle.h，circle類的聲明
#ifndef CIRCLE_H
#define CIRCLE_H
#include "point.h"
#ifdef DLL_FILE
class _declspec(dllexport)circle //導出類circle
#else
class _declspec(dllimport)circle //導入類circle
#endif
{
public:
void SetCentre(const point ¢rePoint);
void SetRadius(float r);
float GetGirth();
float GetArea();
circle();
private:
float radius;
point centre;
};
#endif
//文件名：circle.cpp，circle類的實現
#ifndef DLL_FILE
#define DLL_FILE
#endif
#include "circle.h"
#define PI 3.1415926
//circle類的構造函數
circle::circle()
{
centre = point(0, 0);
radius = 0;
}
//獲得圓的面積
float circle::GetArea()
{
return PI *radius * radius;
}
//獲得圓的周長
float circle::GetGirth()
{
return 2 *PI * radius;
}
//設置圓心座標
void circle::SetCentre(const point ¢rePoint)
{
centre = centrePoint;
}
//設置圓的半徑
void circle::SetRadius(float r)
{
radius = r;
}

類的引用：

#include "..\circle.h"　　//包含類聲明頭文件
#pragma comment(lib,"dllTest.lib");
int main(int argc, char *argv[])
{
circle c;
point p(2.0, 2.0);
c.SetCentre(p);
c.SetRadius(1.0);
printf("area:%f girth:%f", c.GetArea(), c.GetGirth());
return 0;
}

　　從上述源代碼能夠看出，因爲在DLL的類實現代碼中定義了宏DLL_FILE，故在DLL的實現中所包含的類聲明實際上爲：

class _declspec(dllexport) point //導出類point
{
…
}

　　和

class _declspec(dllexport) circle //導出類circle
{
…
}

　　而在應用工程中沒有定義DLL_FILE，故其包含point.h和circle.h後引入的類聲明爲：

class _declspec(dllimport) point //導入類point
{
…
}

　　和

class _declspec(dllimport) circle //導入類circle
{
…
}

不錯，正是經過DLL中的

class _declspec(dllexport) class_name //導出類circle　
{
…
}

　　與應用程序中的

class _declspec(dllimport) class_name //導入類
{
…
}

　　匹對來完成類的導出和導入的！
　　咱們每每經過在類的聲明頭文件中用一個宏來決定使其編譯爲class _declspec(dllexport) class_name仍是class _declspec(dllimport) class_name版本，這樣就再也不須要兩個頭文件。本程序中使用的是：

#ifdef DLL_FILE
class _declspec(dllexport) class_name //導出類
#else
class _declspec(dllimport) class_name //導入類
#endif

　　實際上，在MFC DLL的講解中，您將看到比這更簡便的方法，而此處僅僅是爲了說明_declspec(dllexport)與_declspec(dllimport)匹對的問題。
　　因而可知，應用工程中幾乎能夠看到DLL中的一切，包括函數、變量以及類，這就是DLL所要提供的強大能力。只要DLL釋放這些接口，應用程序使用它就將如同使用本工程中的程序同樣！
　　本章雖以VC++爲平臺講解非MFC DLL，可是這些廣泛的概念在其它語言及開發環境中也是相同的，其思惟方式能夠直接過渡。
　　接下來，咱們將要研究MFC規則DLL(待續...)

第4節咱們對非MFC DLL進行了介紹，這一節將詳細地講述MFC規則DLL的建立與使用技巧。
　　另外，自從本文開始連載後，收到了一些讀者的e-mail。有的讀者提出了一些問題，筆者將在本文的最後一次連載中選取其中的典型問題進行解答。因爲時間的關係，對於讀者朋友的來信，筆者暫時不能一一回復，還望海涵！因爲筆者的水平有限，文中不免有錯誤和紕漏，也熱誠歡迎讀者朋友不吝指正！
5. MFC規則DLL
5.1 概述
　　MFC規則DLL的概念體如今兩方面：
　　（1）它是MFC的
　　「是MFC的」意味着能夠在這種DLL的內部使用MFC；
　　（2）它是規則的
　　「是規則的」意味着它不一樣於MFC擴展DLL，在MFC規則DLL的內部雖然可使用MFC，可是其與應用程序的接口不能是MFC。而MFC擴展DLL與應用程序的接口能夠是MFC，能夠從MFC擴展DLL中導出一個MFC類的派生類。
　　Regular DLL可以被全部支持DLL技術的語言所編寫的應用程序調用，固然也包括使用MFC的應用程序。在這種動態鏈接庫中，包含一個從CWinApp繼承下來的類，DllMain函數則由MFC自動提供。
　　Regular DLL分爲兩類：
　　（1）靜態連接到MFC 的規則DLL
　　靜態連接到MFC的規則DLL與MFC庫（包括MFC擴展 DLL）靜態連接，將MFC庫的代碼直接生成在.dll文件中。在調用這種DLL的接口時，MFC使用DLL的資源。所以，在靜態連接到MFC 的規則DLL中不須要進行模塊狀態的切換。
　　使用這種方法生成的規則DLL其程序較大，也可能包含重複的代碼。
　　（2）動態連接到MFC 的規則DLL
　　動態連接到MFC 的規則DLL 能夠和使用它的可執行文件同時動態連接到 MFC DLL 和任何MFC擴展 DLL。在使用了MFC共享庫的時候，默認狀況下，MFC使用主應用程序的資源句柄來加載資源模板。這樣，當DLL和應用程序中存在相同ID的資源時（即所謂的資源重複問題），系統可能不能得到正確的資源。所以，對於共享MFC DLL的規則DLL，咱們必須進行模塊切換以使得MFC可以找到正確的資源模板。
咱們能夠在Visual C++中設置MFC規則DLL是靜態連接到MFC DLL仍是動態連接到MFC DLL。如圖8，依次選擇Visual C++的project -> Settings -> General菜單或選項，在Microsoft Foundation Classes中進行設置。

圖8 設置動態/靜態連接MFC DLL

5.2 MFC規則DLL的建立
　　咱們來一步步講述使用MFC嚮導建立MFC規則DLL的過程，首先新建一個project，如圖9，選擇project的類型爲MFC AppWizard(dll)。點擊OK進入如圖10所示的對話框。

圖9 MFC DLL工程的建立

圖10所示對話框中的1區選擇MFC DLL的類別。
　　2區選擇是否支持automation（自動化）技術， automation 容許用戶在一個應用程序中操縱另一個應用程序或組件。例如，咱們能夠在應用程序中利用 Microsoft Word 或Microsoft Excel的工具，而這種使用對用戶而言是透明的。自動化技術能夠大大簡化和加快應用程序的開發。
　　3區選擇是否支持Windows Sockets，當選擇此項目時，應用程序能在 TCP/IP 網絡上進行通訊。 CWinApp派生類的InitInstance成員函數會初始化通信端的支持，同時工程中的StdAfx.h文件會自動include <AfxSock.h>頭文件。
添加socket通信支持後的InitInstance成員函數以下：

BOOL CRegularDllSocketApp::InitInstance()
{
if (!AfxSocketInit())
{
AfxMessageBox(IDP_SOCKETS_INIT_FAILED);
return FALSE;
}
return TRUE;
}

　　4區選擇是否由MFC嚮導自動在源代碼中添加註釋，通常咱們選擇「Yes,please」。

圖10 MFC DLL的建立選項

5.3 一個簡單的MFC規則DLL
　　這個DLL的例子（屬於靜態連接到MFC 的規則DLL）中提供了一個如圖11所示的對話框。

圖11 MFC規則DLL例子

在DLL中添加對話框的方式與在MFC應用程序中是同樣的。
　　在圖11所示DLL中的對話框的Hello按鈕上點擊時將MessageBox一個「Hello,pconline的網友」對話框，下面是相關的文件及源代碼，其中刪除了MFC嚮導自動生成的絕大多數註釋（下載本工程附件）：
第一組文件：CWinApp繼承類的聲明與實現

// RegularDll.h : main header file for the REGULARDLL DLL
#if !defined(AFX_REGULARDLL_H__3E9CB22B_588B_4388_B778_B3416ADB79B3__INCLUDED_)
#define AFX_REGULARDLL_H__3E9CB22B_588B_4388_B778_B3416ADB79B3__INCLUDED_
#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000
#ifndef __AFXWIN_H__
#error include 'stdafx.h' before including this file for PCH
#endif
#include "resource.h" // main symbols
class CRegularDllApp : public CWinApp
{
public:
CRegularDllApp();
DECLARE_MESSAGE_MAP()
};
#endif
// RegularDll.cpp : Defines the initialization routines for the DLL.
#include "stdafx.h"
#include "RegularDll.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif
BEGIN_MESSAGE_MAP(CRegularDllApp, CWinApp)
END_MESSAGE_MAP()
/////////////////////////////////////////////////////////////////////////////
// CRegularDllApp construction
CRegularDllApp::CRegularDllApp()
{
}
/////////////////////////////////////////////////////////////////////////////
// The one and only CRegularDllApp object
CRegularDllApp theApp;

　　分析：
　　在這一組文件中定義了一個繼承自CWinApp的類CRegularDllApp，並同時定義了其的一個實例theApp。乍一看，您會覺得它是一個 MFC應用程序，由於MFC應用程序也包含這樣的在工程名後添加「App」組成類名的類（並繼承自CWinApp類），也定義了這個類的一個全局實例 theApp。
　　咱們知道，在MFC應用程序中CWinApp取代了SDK程序中WinMain的地位，SDK程序WinMain所完成的工做由CWinApp的三個函數完成：

virtual BOOL InitApplication( );
virtual BOOL InitInstance( );
virtual BOOL Run( ); //傳說中MFC程序的「活水源頭」

　　可是MFC規則DLL並非MFC應用程序，它所繼承自CWinApp的類不包含消息循環。這是由於，MFC規則DLL不包含CWinApp::Run 機制，主消息泵仍然由應用程序擁有。若是DLL 生成無模式對話框或有本身的主框架窗口，則應用程序的主消息泵必須調用從DLL 導出的函數來調用PreTranslateMessage成員函數。
　　另外，MFC規則DLL與MFC 應用程序中同樣，須要將全部 DLL中元素的初始化放到InitInstance 成員函數中。
　　第二組文件自定義對話框類聲明及實現(點擊查看附件)
　　分析：
　　這一部分的編程與通常的應用程序根本沒有什麼不一樣，咱們照樣能夠利用MFC類嚮導來自動爲對話框上的控件添加事件。MFC類嚮導照樣會生成相似ON_BN_CLICKED(IDC_HELLO_BUTTON, OnHelloButton)的消息映射宏。
　　第三組文件 DLL中的資源文件

//{{NO_DEPENDENCIES}}
// Microsoft Developer Studio generated include file.
// Used by RegularDll.rc
//
#define IDD_DLL_DIALOG 1000
#define IDC_HELLO_BUTTON 1000

　　分析：
　　在MFC規則DLL中使用資源也與在MFC應用程序中使用資源沒有什麼不一樣，咱們照樣能夠用Visual C++的資源編輯工具進行資源的添加、刪除和屬性的更改。
　　第四組文件 MFC規則DLL接口函數

#include "StdAfx.h"
#include "DllDialog.h"
extern "C" __declspec(dllexport) void ShowDlg(void)
{
CDllDialog dllDialog;
dllDialog.DoModal();
}

　　分析：
　　這個接口並不使用MFC，可是在其中卻能夠調用MFC擴展類CdllDialog的函數，這體現了「規則」的概類。
　　與非MFC DLL徹底相同，咱們可使用__declspec(dllexport)聲明或在.def中引出的方式導出MFC規則DLL中的接口。
5.4 MFC規則DLL的調用
　　筆者編寫了如圖12的對話框MFC程序（下載本工程附件）來調用5.3節的MFC規則DLL，在這個程序的對話框上點擊「調用DLL」按鈕時彈出5.3節MFC規則DLL中的對話框。

圖12 MFC規則DLL的調用例子

　　下面是「調用DLL」按鈕單擊事件的消息處理函數：

void CRegularDllCallDlg::OnCalldllButton()
{
typedef void (*lpFun)(void);
HINSTANCE hDll; //DLL句柄
hDll = LoadLibrary("RegularDll.dll");
if (NULL==hDll)
{
MessageBox("DLL加載失敗");
}
lpFun addFun; //函數指針
lpFun pShowDlg = (lpFun)GetProcAddress(hDll,"ShowDlg");
if (NULL==pShowDlg)
{
MessageBox("DLL中函數尋找失敗");
}
pShowDlg();
}

　　上述例子中給出的是顯示調用的方式，能夠看出，其調用方式與第4節中非MFC DLL的調用方式沒有什麼不一樣。
　　咱們照樣能夠在EXE程序中隱式調用MFC規則DLL，只須要將DLL工程生成的.lib文件和.dll文件拷入當前工程所在的目錄，並在RegularDllCallDlg.cpp文件（圖12所示對話框類的實現文件）的頂部添加：

#pragma comment(lib,"RegularDll.lib")
void ShowDlg(void);

　　並將void CRegularDllCallDlg::OnCalldllButton() 改成：

void CRegularDllCallDlg::OnCalldllButton()
{
ShowDlg();
}

5.5 共享MFC DLL的規則DLL的模塊切換
　　應用程序進程自己及其調用的每一個DLL模塊都具備一個全局惟一的HINSTANCE句柄，它們表明了DLL或EXE模塊在進程虛擬空間中的起始地址。進程自己的模塊句柄通常爲0x400000，而DLL模塊的缺省句柄爲0x10000000。若是程序同時加載了多個DLL，則每一個DLL模塊都會有不一樣的 HINSTANCE。應用程序在加載DLL時對其進行了重定位。
　　共享MFC DLL（或MFC擴展DLL）的規則DLL涉及到HINSTANCE句柄問題，HINSTANCE句柄對於加載資源特別重要。EXE和DLL都有其本身的資源，並且這些資源的ID可能重複，應用程序須要經過資源模塊的切換來找到正確的資源。若是應用程序須要來自於DLL的資源，就應將資源模塊句柄指定爲 DLL的模塊句柄；若是須要EXE文件中包含的資源，就應將資源模塊句柄指定爲EXE的模塊句柄。
　　此次咱們建立一個動態連接到MFC DLL的規則DLL（下載本工程附件），在其中包含如圖13的對話框。

圖13 DLL中的對話框

　　另外，在與這個DLL相同的工做區中生成一個基於對話框的MFC程序，其對話框與圖12徹底同樣。可是在此工程中咱們另外添加了一個如圖14的對話框。

圖14 EXE中的對話框

圖13和圖14中的對話框除了caption不一樣（以示區別）之外，其它的都相同。
　　尤爲值得特別注意，在DLL和EXE中咱們對圖13和圖14的對話框使用了相同的資源ID=2000，在DLL和EXE工程的resource.h中分別有以下的宏：

//DLL中對話框的ID
#define IDD_DLL_DIALOG 2000
//EXE中對話框的ID
#define IDD_EXE_DIALOG 2000

　　與5.3節靜態連接MFC DLL的規則DLL相同，咱們仍是在規則DLL中定義接口函數ShowDlg，原型以下：

#include "StdAfx.h"
#include "SharedDll.h"
void ShowDlg(void)
{
CDialog dlg(IDD_DLL_DIALOG); //打開ID爲2000的對話框
dlg.DoModal();
}

　　而爲應用工程主對話框的「調用DLL」的單擊事件添加以下消息處理函數：

void CSharedDllCallDlg::OnCalldllButton()
{
ShowDlg();
}

　　咱們覺得單擊「調用DLL」會彈出如圖13所示DLL中的對話框，但是可怕的事情發生了，咱們看到是圖14所示EXE中的對話框！
驚訝？
　　產生這個問題的根源在於應用程序與MFC規則DLL共享MFC DLL（或MFC擴展DLL）的程序老是默認使用EXE的資源，咱們必須進行資源模塊句柄的切換，其實現方法有三：
　　方法一在DLL接口函數中使用：

AFX_MANAGE_STATE(AfxGetStaticModuleState());

　　咱們將DLL中的接口函數ShowDlg改成：

void ShowDlg(void)
{
//方法1:在函數開始處變動，在函數結束時恢復
//將AFX_MANAGE_STATE(AfxGetStaticModuleState());做爲接口函數的第一//條語句進行模塊狀態切換
AFX_MANAGE_STATE(AfxGetStaticModuleState());
CDialog dlg(IDD_DLL_DIALOG);//打開ID爲2000的對話框
dlg.DoModal();
}

　　此次咱們再點擊EXE程序中的「調用DLL」按鈕，彈出的是DLL中的如圖13的對話框！嘿嘿，彈出了正確的對話框資源。
AfxGetStaticModuleState是一個函數，其原型爲：

AFX_MODULE_STATE* AFXAPI AfxGetStaticModuleState( );

　　該函數的功能是在棧上（這意味着其做用域是局部的）建立一個AFX_MODULE_STATE類（模塊全局數據也就是模塊狀態）的實例，對其進行設置，並將其指針pModuleState返回。
AFX_MODULE_STATE類的原型以下：

// AFX_MODULE_STATE (global data for a module)
class AFX_MODULE_STATE : public CNoTrackObject
{
public:
#ifdef _AFXDLL
AFX_MODULE_STATE(BOOL bDLL, WNDPROC pfnAfxWndProc, DWORD dwVersion);
AFX_MODULE_STATE(BOOL bDLL, WNDPROC pfnAfxWndProc, DWORD dwVersion,BOOL bSystem);
#else
AFX_MODULE_STATE(BOOL bDLL);
#endif
~AFX_MODULE_STATE();
CWinApp* m_pCurrentWinApp;
HINSTANCE m_hCurrentInstanceHandle;
HINSTANCE m_hCurrentResourceHandle;
LPCTSTR m_lpszCurrentAppName;
… //省略後面的部分
}

　　AFX_MODULE_STATE類利用其構造函數和析構函數進行存儲模塊狀態現場及恢復現場的工做，相似彙編中call指令對pc指針和sp寄存器的保存與恢復、中斷服務程序的中斷現場壓棧與恢復以及操做系統線程調度的任務控制塊保存與恢復。
　　許多看似不着邊際的知識點竟然有驚人的類似！
　　AFX_MANAGE_STATE是一個宏，其原型爲：

AFX_MANAGE_STATE( AFX_MODULE_STATE* pModuleState )

　　該宏用於將pModuleState設置爲當前的有效模塊狀態。當離開該宏的做用域時（也就離開了pModuleState所指向棧上對象的做用域），先前的模塊狀態將由AFX_MODULE_STATE的析構函數恢復。
　　方法二在DLL接口函數中使用：

AfxGetResourceHandle();
AfxSetResourceHandle(HINSTANCE xxx);

　　AfxGetResourceHandle用於獲取當前資源模塊句柄，而AfxSetResourceHandle則用於設置程序目前要使用的資源模塊句柄。
　　咱們將DLL中的接口函數ShowDlg改成：

void ShowDlg(void)
{
//方法2的狀態變動
HINSTANCE save_hInstance = AfxGetResourceHandle();
AfxSetResourceHandle(theApp.m_hInstance);
CDialog dlg(IDD_DLL_DIALOG);//打開ID爲2000的對話框
dlg.DoModal();
//方法2的狀態還原
AfxSetResourceHandle(save_hInstance);
}

　　經過AfxGetResourceHandle和AfxSetResourceHandle的合理變動，咱們可以靈活地設置程序的資源模塊句柄，而方法一則只能在DLL接口函數退出的時候纔會恢復模塊句柄。方法二則不一樣，若是將ShowDlg改成：

extern CSharedDllApp theApp; //須要聲明theApp外部全局變量
void ShowDlg(void)
{
//方法2的狀態變動
HINSTANCE save_hInstance = AfxGetResourceHandle();
AfxSetResourceHandle(theApp.m_hInstance);
CDialog dlg(IDD_DLL_DIALOG);//打開ID爲2000的對話框
dlg.DoModal();
//方法2的狀態還原
AfxSetResourceHandle(save_hInstance);
//使用方法2後在此處再進行操做針對的將是應用程序的資源
CDialog dlg1(IDD_DLL_DIALOG); //打開ID爲2000的對話框
dlg1.DoModal();
}

　　在應用程序主對話框的「調用DLL」按鈕上點擊，將看到兩個對話框，相繼爲DLL中的對話框（圖13）和EXE中的對話框（圖14）。
　　方法三由應用程序自身切換
　　資源模塊的切換除了能夠由DLL接口函數完成之外，由應用程序自身也能完成（下載本工程附件）。
　　如今咱們把DLL中的接口函數改成最簡單的：

void ShowDlg(void)
{
CDialog dlg(IDD_DLL_DIALOG); //打開ID爲2000的對話框
dlg.DoModal();
}

　　而將應用程序的OnCalldllButton函數改成：

void CSharedDllCallDlg::OnCalldllButton()
{
//方法3：由應用程序自己進行狀態切換
//獲取EXE模塊句柄
HINSTANCE exe_hInstance = GetModuleHandle(NULL);
//或者HINSTANCE exe_hInstance = AfxGetResourceHandle();
//獲取DLL模塊句柄
HINSTANCE dll_hInstance = GetModuleHandle("SharedDll.dll");
AfxSetResourceHandle(dll_hInstance); //切換狀態
ShowDlg(); //此時顯示的是DLL的對話框
AfxSetResourceHandle(exe_hInstance); //恢復狀態
//資源模塊恢復後再調用ShowDlg
ShowDlg(); //此時顯示的是EXE的對話框
}

　　方法三中的Win32函數GetModuleHandle能夠根據DLL的文件名獲取DLL的模塊句柄。若是須要獲得EXE模塊的句柄，則應調用帶有Null參數的GetModuleHandle。
　　方法三與方法二的不一樣在於方法三是在應用程序中利用AfxGetResourceHandle和AfxSetResourceHandle進行資源模塊句柄切換的。一樣地，在應用程序主對話框的「調用DLL」按鈕上點擊，也將看到兩個對話框，相繼爲DLL中的對話框（圖13）和EXE中的對話框（圖 14）。
　　在下一節咱們將對MFC擴展DLL進行詳細分析和實例講解，歡迎您繼續關注本系列連載。

這是《VC++動態連接庫(DLL)編程深刻淺出》的第四部分，閱讀本文前，請先閱讀前三部分：（一）、（二）、（三）。　MFC擴展DLL的內涵爲MFC的擴展，用戶使用MFC擴展DLL就像使用MFC自己的DLL同樣。除了能夠在MFC擴展DLL的內部使用MFC之外， MFC擴展DLL與應用程序的接口部分也能夠是MFC。咱們通常使用MFC擴展DLL來包含一些MFC的加強功能，譬如擴展MFC的CStatic、 CButton等類使之具有更強大的能力。

　　使用Visual C++嚮導生產MFC擴展DLL時，MFC嚮導會自動增長DLL的入口函數DllMain：

extern "C" int APIENTRY
DllMain(HINSTANCE hInstance, DWORD dwReason, LPVOID lpReserved)
{
// Remove this if you use lpReserved
UNREFERENCED_PARAMETER(lpReserved);
if (dwReason == DLL_PROCESS_ATTACH)
{
TRACE0("MFCEXPENDDLL.DLL Initializing!\n");
// Extension DLL one-time initialization
if (!AfxInitExtensionModule(MfcexpenddllDLL, hInstance))
return 0;
// Insert this DLL into the resource chain
// NOTE: If this Extension DLL is being implicitly linked to by
// an MFC Regular DLL (such as an ActiveX Control)
// instead of an MFC application, then you will want to
// remove this line from DllMain and put it in a separate
// function exported from this Extension DLL. The Regular DLL
// that uses this Extension DLL should then explicitly call that
// function to initialize this Extension DLL. Otherwise,
// the CDynLinkLibrary object will not be attached to the
// Regular DLL's resource chain, and serious problems will
// result.
new CDynLinkLibrary(MfcexpenddllDLL);
}
else if (dwReason == DLL_PROCESS_DETACH)
{
TRACE0("MFCEXPENDDLL.DLL Terminating!\n");
// Terminate the library before destructors are called
AfxTermExtensionModule(MfcexpenddllDLL);
}
return 1; // ok
}

　　上述代碼完成MFC擴展DLL的初始化和終止處理。

　　因爲MFC擴展DLL導出函數和變量的方式與其它DLL沒有什麼區別，咱們再也不細緻講解。下面直接給出一個MFC擴展DLL的建立及在應用程序中調用它的例子。

6.1 MFC擴展DLL的建立

　　下面咱們將在MFC擴展DLL中導出一個按鈕類CSXButton（擴展自MFC的CButton類），類CSXButton是一個用以取代 CButton的類，它使你能在同一個按鈕上顯示位圖和文字，而MFC的按鈕僅可顯示兩者之一。類CSXbutton的源代碼在Internet上普遍流傳，有很好的「羣衆基礎」，所以用這個類來說解MFC擴展DLL有其特殊的功效。

　　MFC中包含一些宏，這些宏在DLL和調用DLL的應用程序中被以不一樣的方式展開，這使得在DLL和應用程序中，使用統一的一個宏就能夠表示出輸出和輸入的不一樣意思：

// for data
#ifndef AFX_DATA_EXPORT
#define AFX_DATA_EXPORT __declspec(dllexport)
#endif
#ifndef AFX_DATA_IMPORT
#define AFX_DATA_IMPORT __declspec(dllimport)
#endif
// for classes
#ifndef AFX_CLASS_EXPORT
#define AFX_CLASS_EXPORT __declspec(dllexport)
#endif
#ifndef AFX_CLASS_IMPORT
#define AFX_CLASS_IMPORT __declspec(dllimport)
#endif
// for global APIs
#ifndef AFX_API_EXPORT
#define AFX_API_EXPORT __declspec(dllexport)
#endif
#ifndef AFX_API_IMPORT
#define AFX_API_IMPORT __declspec(dllimport)
#endif
#ifndef AFX_EXT_DATA
#ifdef _AFXEXT
#define AFX_EXT_CLASS AFX_CLASS_EXPORT
#define AFX_EXT_API AFX_API_EXPORT
#define AFX_EXT_DATA AFX_DATA_EXPORT
#define AFX_EXT_DATADEF
#else
#define AFX_EXT_CLASS AFX_CLASS_IMPORT
#define AFX_EXT_API AFX_API_IMPORT
#define AFX_EXT_DATA AFX_DATA_IMPORT
#define AFX_EXT_DATADEF
#endif
#endif

　　導出一個類，直接在類聲明頭文件中使用AFX_EXT_CLASS便可，如下是導出CSXButton類的例子：

#ifndef _SXBUTTON_H
#define _SXBUTTON_H
#define SXBUTTON_CENTER -1
class AFX_EXT_CLASS CSXButton : public CButton
{
// Construction
public:
CSXButton();
// Attributes
private:
// Positioning
BOOL m_bUseOffset;
CPoint m_pointImage;
CPoint m_pointText;
int m_nImageOffsetFromBorder;
int m_nTextOffsetFromImage;
// Image
HICON m_hIcon;
HBITMAP m_hBitmap;
HBITMAP m_hBitmapDisabled;
int m_nImageWidth, m_nImageHeight;
// Color Tab
char m_bColorTab;
COLORREF m_crColorTab;
// State
BOOL m_bDefault;
UINT m_nOldAction;
UINT m_nOldState;
// Operations
public:
// Positioning
int SetImageOffset( int nPixels );
int SetTextOffset( int nPixels );
CPoint SetImagePos( CPoint p );
CPoint SetTextPos( CPoint p );
// Image
BOOL SetIcon( UINT nID, int nWidth, int nHeight );
BOOL SetBitmap( UINT nID, int nWidth, int nHeight );
BOOL SetMaskedBitmap( UINT nID, int nWidth, int nHeight, COLORREF crTransparentMask );
BOOL HasImage() { return (BOOL)( m_hIcon != 0 | m_hBitmap != 0 ); }
// Color Tab
void SetColorTab(COLORREF crTab);
// State
BOOL SetDefaultButton( BOOL bState = TRUE );
private:
BOOL SetBitmapCommon( UINT nID, int nWidth, int nHeight, COLORREF crTransparentMask, BOOL bUseMask );
void CheckPointForCentering( CPoint &p, int nWidth, int nHeight );
void Redraw();
// Overrides
// ClassWizard generated virtual function overrides
//{{AFX_VIRTUAL(CSXButton)
public:
virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);
//}}AFX_VIRTUAL
// Implementation
public:
virtual ~CSXButton();
// Generated message map functions
protected:
//{{AFX_MSG(CSXButton)
afx_msg LRESULT OnGetText(WPARAM wParam, LPARAM lParam);
//}}AFX_MSG
DECLARE_MESSAGE_MAP()
};
#endif

　　把SXBUTTON.CPP文件直接添加到工程，編譯工程，獲得「mfcexpenddll.lib」和「mfcexpenddll.dll」兩個文件。咱們用Visual Studio自帶的Depends工具能夠查看這個.dll，發現其導出了衆多符號（見圖15）。

圖15 導出類時導出的大量符號 (＋放大該圖片)

　　這些都是類的構造函數、析構函數及其它成員函數和變量經編譯器處理過的符號，咱們直接用__declspec(dllexport)語句聲明類就導出了這些符號。

　　若是咱們想用.lib文件導出這些符號，是很是困難的，咱們須要在工程中生成.map文件，查詢.map文件的符號，而後將其一一導出。如圖16，打開 DLL工程的settings選項，再選擇Link，勾選其中的產生MAP文件（Generate mapfile）就能夠產生.map文件了。

打開mfcexpenddll工程生成的.map文件，咱們發現其中包含了圖15中所示的符號（symbol）

0001:00000380 ?HasImage@CSXButton@@QAEHXZ 10001380 f i SXBUTTON.OBJ
0001:000003d0 ??0CSXButton@@QAE@XZ 100013d0 f SXBUTTON.OBJ
0001:00000500 ??_GCSXButton@@UAEPAXI@Z 10001500 f i SXBUTTON.OBJ
0001:00000570 ??_ECSXButton@@UAEPAXI@Z 10001570 f i SXBUTTON.OBJ
0001:00000630 ??1CSXButton@@UAE@XZ 10001630 f SXBUTTON.OBJ
0001:00000700 ?_GetBaseMessageMap@CSXButton@@KGPBUAFX_MSGMAP@@XZ 10001700 f SXBUTTON.OBJ
0001:00000730 ?GetMessageMap@CSXButton@@MBEPBUAFX_MSGMAP@@XZ 10001730 f SXBUTTON.OBJ
0001:00000770 ?Redraw@CSXButton@@AAEXXZ 10001770 f i SXBUTTON.OBJ
0001:000007d0 ?SetIcon@CSXButton@@QAEHIHH@Z 100017d0 f SXBUTTON.OBJ
……………………………………………………………………..//省略

圖16 產生.map文件 (＋放大該圖片)

　　因此，對於MFC擴展DLL，咱們不宜以.lib文件導出類。

6.2 MFC擴展DLL的調用

　　在DLL所在工做區新增一個dllcall工程，它是一個基於對話框的MFC EXE程序。在其中增長兩個按鈕SXBUTTON一、SXBUTTON2，並設置其屬性爲「Owner draw」，如圖17。

圖17 設置按鈕屬性爲「Owner draw」

　　在工程中添加兩個ICON資源：IDI_MSN_ICON（MSN的圖標）、IDI_REFBAR_ICON（Windows的系統圖標）。

　　修改工程的「calldllDlg.h」頭文件爲：

#include "..\..\mfcexpenddll\SXBUTTON.h" //包含dll的導出類頭文件
#pragma comment(lib,"mfcexpenddll.lib") //隱式連接dll
/////////////////////////////////////////////////////////////////////////////
// CCalldllDlg dialog
class CCalldllDlg : public CDialog
{
// Construction
public:
CCalldllDlg(CWnd* pParent = NULL); // standard constructor
// Dialog Data
//{{AFX_DATA(CCalldllDlg)
enum { IDD = IDD_CALLDLL_DIALOG };
//增長與兩個按鈕對應的成員變量
CSXButton m_button1;
CSXButton m_button2;
…
}

　　同時，修改「calldllDlg.cpp」文件，使得m_button一、m_button2成員變量與對話框上的按鈕控件創建關聯：

void CCalldllDlg::DoDataExchange(CDataExchange* pDX)
{
CDialog::DoDataExchange(pDX);
//{{AFX_DATA_MAP(CCalldllDlg)
DDX_Control(pDX, IDC_BUTTON2, m_button2);
DDX_Control(pDX, IDC_BUTTON1, m_button1);
//}}AFX_DATA_MAP
}

　　修改BOOL CCalldllDlg::OnInitDialog()函數，在其中增長對兩個按鈕設置ICON的代碼：

BOOL CCalldllDlg::OnInitDialog()
{
CDialog::OnInitDialog();
// Add "About..." menu item to system menu.
// IDM_ABOUTBOX must be in the system command range.
ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);
ASSERT(IDM_ABOUTBOX < 0xF000);
CMenu* pSysMenu = GetSystemMenu(FALSE);
if (pSysMenu != NULL)
{
CString strAboutMenu;
strAboutMenu.LoadString(IDS_ABOUTBOX);
if (!strAboutMenu.IsEmpty())
{
pSysMenu->AppendMenu(MF_SEPARATOR);
pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu);
}
}
// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE); // Set big icon
SetIcon(m_hIcon, FALSE); // Set small icon
// TODO: Add extra initialization here
m_button1.SetIcon(IDI_MSN_ICON,16,16);
m_button2.SetIcon(IDI_REFBAR_ICON,16,16);
return TRUE; // return TRUE unless you set the focus to a control
}