在DLL中使用資源（一）

yuwei - 轉(zhuǎn)載 （2004-12-10 14:02:00）  .Net控件開(kāi)發(fā) ActiveX/COM開(kāi)發(fā) CLX/VCL開(kāi)發(fā) Java組件開(kāi)發(fā) VC/MFC 控件使用經(jīng)驗(yàn)談 DHtml/Script 控件開(kāi)發(fā)基礎(chǔ) 數(shù)據(jù)庫(kù) 編程規(guī)范 單元測(cè)試 可重用軟件技術(shù)理論 其 它
 
 
 
   

在DLL中使用資源（一）
現(xiàn)在最常看見(jiàn)的關(guān)于DLL的問(wèn)題就是如何在DLL中使用對(duì)話框，這是一個(gè)很普遍的關(guān)于如何在DLL中使用資源的問(wèn)題。這里我們從Win32 DLL和MFC DLL兩個(gè)方面來(lái)分析并解決這個(gè)問(wèn)題。

1．Win32 DLL
在Win32 DLL中使用對(duì)話框很簡(jiǎn)單，你只需要在你的DLL中添加對(duì)話框資源，而且可以在對(duì)話框上面設(shè)置你所需要的控件。然后使用DialogBox或者CreateDialog這兩個(gè)函數(shù)（或相同作用的其它函數(shù)）來(lái)創(chuàng)建對(duì)話框，并定義你自己的對(duì)話框回調(diào)函數(shù)處理對(duì)話框收到的消息。下面通過(guò)一個(gè)具體實(shí)例來(lái)學(xué)習(xí)如何在Win32 DLL中使用對(duì)話框，可以按照以下步驟來(lái)完成這個(gè)例子：


1）在VC菜單中File->New新建一個(gè)命名為UseDlg的Win32 Dynamic-Link Library工程，下一步選擇A simple DLL project。


2）在VC菜單中Insert->Resource添加一個(gè)ID為IDD_DLG_SHOW的Dialog資源，將此Dialog上的Cancel按鈕去掉，僅保留OK按鈕。再添加一個(gè)ID為IDD_ABOUTBOX的對(duì)話框，其Caption為About。保存此資源，將資源文件命名為UseDlg.rc。并將resource.h和UseDlg.rc加入到工程里面。


3）在UseDlg.app中包含resource.h，并添加如下代碼：


HINSTANCE hinst = NULL;

HWND hwndDLG = NULL;


BOOL CALLBACK DlgProc(HWND hDlg, UINT message,

WPARAM wParam, LPARAM lParam);

BOOL CALLBACK AboutProc(HWND hDlg, UINT message,

WPARAM wParam, LPARAM lParam);

extern "C" __declspec(dllexport) void ShowDlg();


BOOL APIENTRY DllMain( HANDLE hModule,

DWORD ul_reason_for_call,

LPVOID lpReserved

)

{

switch(ul_reason_for_call)

{

case DLL_PROCESS_ATTACH:

hinst = (HINSTANCE)hModule;

case DLL_PROCESS_DETACH:

break;

}

return TRUE;

}


extern "C" __declspec(dllexport) void ShowDlg()

{

hwndDLG = CreateDialog(hinst,MAKEINTRESOURCE(IDD_DLG_SHOW),

NULL,(DLGPROC)DlgProc);

ShowWindow(hwndDLG, SW_SHOW);

}


BOOL CALLBACK DlgProc(HWND hDlg, UINT message,

WPARAM wParam, LPARAM lParam)

{

switch(message)

{

case WM_INITDIALOG:

return TRUE;


case WM_COMMAND:

if(LOWORD(wParam)==IDOK)

DialogBox(hinst,MAKEINTRESOURCE(IDD_ABOUTBOX),

hDlg,(DLGPROC)AboutProc);

return TRUE;

case WM_CLOSE:

DestroyWindow(hDlg);

hwndDLG = NULL;

return TRUE;

}

return FALSE;

}


BOOL CALLBACK AboutProc(HWND hDlg, UINT message,

WPARAM wParam, LPARAM lParam)

{

switch(message)

{

case WM_CLOSE:

EndDialog(hDlg,NULL);

hwndDLG = NULL;

return TRUE;

}

return FALSE;

}


4）編譯生成UseDlg.dll和UseDlg.lib。


接下來(lái)我們建立調(diào)用此DLL的應(yīng)用程序，其步驟如下：



1）在VC菜單中File->New新建一個(gè)命名為Use的MFC AppWizard(exe)工程，下一步選擇Dialog Based之后點(diǎn)擊Finish按鈕。


2）在主對(duì)話框上面添加一個(gè)按鈕，之后雙擊此按鈕，會(huì)彈出Add Member Function的對(duì)話框，直接點(diǎn)擊OK進(jìn)入void CUseDlg::OnButton1()函數(shù)。并在此函數(shù)內(nèi)添加一個(gè)函數(shù)調(diào)用：ShowDlg();。


3）緊跟在#include語(yǔ)句后面加上如下代碼：


extern "C" __declspec(dllexport) void ShowDlg();

#pragma comment(lib,"debug/UseDlg")


4）將上面UseDlg工程中生成的UseDlg.dll和UseDlg.lib兩個(gè)文件復(fù)制到Use工程的Debug目錄內(nèi)。


5）編譯生成Use.exe。


運(yùn)行Use.exe，點(diǎn)擊Button1按鈕，可以看到一個(gè)名稱為Dialog的非模態(tài)對(duì)話框彈出。點(diǎn)擊上面的按鈕，可以彈出模態(tài)對(duì)話框About。運(yùn)行成功。


讓我們來(lái)回顧一下在Win32 DLL中使用對(duì)話框的過(guò)程。


在DLL中，我們定義了兩個(gè)對(duì)話框資源：IDD_DLG_SHOW和IDD_ABOUTBOX，并且導(dǎo)出了函數(shù)ShowDlg。在函數(shù)ShowDlg之中使用CreateDialog函數(shù)創(chuàng)建了非模態(tài)對(duì)話框IDD_DLG_SHOW，并指定了該對(duì)話框的回調(diào)函數(shù)DlgProc。在DlgProc之中處理了WM_INITDIALOG、WM_COMMAND和WM_CLOSE消息，以響應(yīng)用戶對(duì)對(duì)話框所做的動(dòng)作。在處理按鈕動(dòng)作的時(shí)候，使用DialogBox函數(shù)創(chuàng)建IDD_ABOUTBOX這個(gè)模態(tài)對(duì)話框，指定其回調(diào)函數(shù)為AboutProc，并且在AboutProc中處理其相應(yīng)消息。


在EXE中，我們使用隱式鏈接的方法來(lái)調(diào)用DLL，并使用DLL中導(dǎo)出的ShowDlg函數(shù)來(lái)調(diào)用DLL中的對(duì)話框。


在Win32 DLL中使用對(duì)話框就是這么簡(jiǎn)單，下面讓我們來(lái)看一下在MFC DLL中如何使用對(duì)話框。

2．MFC DLL
在MFC DLL中使用對(duì)話框不像Win32 DLL中那么簡(jiǎn)單，主要是因?yàn)镸FC程序中存在一個(gè)模塊狀態(tài)（Module State）的問(wèn)題，也就是資源重復(fù)的問(wèn)題。（此處的術(shù)語(yǔ)模塊是指一個(gè)可執(zhí)行程序，或指其操作不依賴于應(yīng)用程序的其余部分但使用MFC運(yùn)行庫(kù)的共享副本的一個(gè)DLL（或一組DLL）。我們所創(chuàng)建的MFC DLL就是這種模塊的一個(gè)典型實(shí)例。）


在每個(gè)模塊（EXE或DLL）中，都存在一種全局的狀態(tài)數(shù)據(jù)，MFC依靠這種全局的狀態(tài)數(shù)據(jù)來(lái)區(qū)分不同的模塊，以執(zhí)行正確的操作。這種數(shù)據(jù)包括：Windows實(shí)例句柄（用于加載資源），指向應(yīng)用程序當(dāng)前的CWinApp和CWinThread對(duì)象的指針，OLE模塊引用計(jì)數(shù)，以及維護(hù)Windows對(duì)象句柄與相應(yīng)的MFC對(duì)象實(shí)例之間連接的各種映射等。但當(dāng)應(yīng)用程序使用多個(gè)模塊時(shí)，每個(gè)模塊的狀態(tài)數(shù)據(jù)不是應(yīng)用程序范圍的。相反，每個(gè)模塊具有自已的MFC狀態(tài)數(shù)據(jù)的私有副本。這種全局的狀態(tài)數(shù)據(jù)就叫做MFC模塊狀態(tài)。


模塊的狀態(tài)數(shù)據(jù)包含在結(jié)構(gòu)中，并且總是可以通過(guò)指向該結(jié)構(gòu)的指針使用。當(dāng)代碼在執(zhí)行時(shí)進(jìn)入了某一個(gè)模塊時(shí)，只有此模塊的狀態(tài)為“當(dāng)前”或“有效”狀態(tài)時(shí)，MFC才能正確的區(qū)分此模塊并執(zhí)行正確的操作。


例如，MFC應(yīng)用程序可以使用下面代碼從資源文件中加載字符串：


CString str;

str.LoadString(IDS_MYSTRING);


使用這種代碼非常方便，但它掩蓋了這樣一個(gè)事實(shí)：即此程序中IDS_MYSTRING可能不是唯一的標(biāo)識(shí)符。一個(gè)程序可以加載多個(gè)DLL，某些DLL可能也用IDS_MYSTRING標(biāo)識(shí)符定義了一個(gè)資源。MFC怎樣知道應(yīng)該加載哪個(gè)資源呢？MFC使用當(dāng)前模塊狀態(tài)查找資源句柄。如果當(dāng)前模塊不是我們要使用的正確模塊，那么就會(huì)產(chǎn)生不正確的調(diào)用或者錯(cuò)誤。



按照MFC庫(kù)的鏈接方法，一個(gè)MFC DLL有兩種使用MFC庫(kù)的方法：靜態(tài)鏈接到MFC的DLL和動(dòng)態(tài)鏈接到MFC的DLL。下面我們就按照這兩種類型的MFC DLL來(lái)介紹如何切換當(dāng)前模塊狀態(tài)以正確的在MFC DLL中使用資源。

1、靜態(tài)鏈接到MFC的DLL

靜態(tài)鏈接到MFC的規(guī)則DLL與MFC庫(kù)靜態(tài)鏈接，則此時(shí)MFC庫(kù)不能共享，所以MFC總是使用它所鏈接的DLL的模塊狀態(tài)。這樣也就不存在管理模塊狀態(tài)的問(wèn)題。但使用這種方法的缺點(diǎn)是DLL程序?qū)?huì)變大，而且會(huì)在程序中留下重復(fù)代碼。下面給出的例子驗(yàn)證了這一點(diǎn)。本例可以按照以下步驟來(lái)完成：


1）在VC菜單中File->New新建一個(gè)命名為DLLStatic的MFC AppWizard的工程，下一步選擇Regular DLL with MFC statically linked。


2）在工程中添加一個(gè)對(duì)話框資源，其ID為：IDD_ABOUTBOX。并在resource.h之中將IDD_ABOUTBOX 的數(shù)值改為100。


3）在DLLStatic.cpp中定義如下函數(shù)：


void ShowDlg()

{

CDialog dlg(IDD_ABOUTBOX);

dlg.DoModal();

}


4）在DLLStatic.def文件中的EXPORTS語(yǔ)句中添加一行：ShowDlg，以導(dǎo)出ShowDlg函數(shù)。


5）編譯生成DLLStatic.dll和DLLStatic.lib。


繼續(xù)使用上一節(jié)中的Use工程，將前面生成的DLLStatic.dll和DLLStatic.lib兩個(gè)文件復(fù)制到工程的Debug目錄內(nèi)，并將


extern "C" __declspec(dllexport) void ShowDlg();

#pragma comment(lib,"debug/UseDlg")


這兩行改為：


void ShowDlg();

#pragma comment(lib,"debug/DLLStatic")


編譯并運(yùn)行Use.exe。點(diǎn)擊按鈕，可以看到DLLStatic中的模態(tài)對(duì)話框彈出。


本例中，可以注意到DLL中所定義的About對(duì)話框資源與EXE中所定義的About對(duì)話框資源ID完全相同，但是當(dāng)我們點(diǎn)擊Use.exe上面的按鈕時(shí)，彈出的是DLL中的模態(tài)對(duì)話框。說(shuō)明，當(dāng)使用靜態(tài)鏈接到MFC的規(guī)則DLL時(shí)，不存在管理模塊狀態(tài)的問(wèn)題。

 
2、動(dòng)態(tài)鏈接到MFC的DLL

在討論關(guān)于動(dòng)態(tài)鏈接到MFC的DLL的模塊狀態(tài)問(wèn)題之前，先來(lái)看一個(gè)例子。本例可以通過(guò)如下步驟來(lái)完成：



1）在VC菜單中File->New新建一個(gè)命名為DLLShared的MFC AppWizard的工程，下一步選擇Regular DLL using shared MFC DLL。



2）在工程中添加一個(gè)對(duì)話框資源，其ID為：IDD_ABOUTBOX。并在resource.h之中將IDD_ABOUTBOX 的數(shù)值改為100。



3）在DLLShared.cpp中定義如下函數(shù)：



void ShowDlg()

{

CDialog dlg(IDD_ABOUTBOX);

dlg.DoModal();

}



4）在DLLShared.def文件中的EXPORTS語(yǔ)句中添加一行：ShowDlg，以導(dǎo)出ShowDlg函數(shù)。



5）編譯生成DLLShared.dll和DLLShared.lib。



繼續(xù)使用上面的Use工程，將前面生成的DLLShared.dll和DLLShared.lib兩個(gè)文件復(fù)制到工程的Debug目錄內(nèi)，并將



extern "C" __declspec(dllexport) void ShowDlg();

#pragma comment(lib,"debug/DLLStatic")



這兩行改為：



void ShowDlg();

#pragma comment(lib,"debug/DLLShared")



編譯并運(yùn)行Use.exe。點(diǎn)擊按鈕，這次你看到了什么？對(duì)，沒(méi)錯(cuò)，這次彈出的是Use.exe的關(guān)于對(duì)話框。將上述例子的DLL類型換成MFC Extension DLL(using shared MFC DLL)也會(huì)出現(xiàn)相同的問(wèn)題。



為什么會(huì)出現(xiàn)上面的問(wèn)題？這是因?yàn)樵谑褂昧薓FC共享庫(kù)的時(shí)候，默認(rèn)情況下，MFC使用主應(yīng)用程序的資源句柄來(lái)加載資源模板。雖然我們調(diào)用的是DLL中的函數(shù)來(lái)顯示DLL中的對(duì)話框，并且對(duì)應(yīng)的對(duì)話框模板是存儲(chǔ)在DLL中的，但MFC仍舊在主應(yīng)用程序也就是Use.exe中尋找相應(yīng)的對(duì)話框模板。由于在DLL中所定義的對(duì)話框資源ID與主應(yīng)用程序中所定義的關(guān)于對(duì)話框的資源ID相同，所以MFC就把主應(yīng)用程序中的關(guān)于對(duì)話框顯示了出來(lái)。如果二者不同，則MFC就認(rèn)為DLL中所定義的對(duì)話框資源不存在，dlg.DoModal會(huì)返回0，也就是什么都不會(huì)顯示。



那么如何解決上述問(wèn)題呢？解決辦法就是在適當(dāng)?shù)臅r(shí)候進(jìn)行模塊狀態(tài)切換，以保證具有當(dāng)前狀態(tài)的模塊是我們所需要的模塊從而使用正確的資源。MFC提供了下列函數(shù)和宏來(lái)完成這些工作：



AfxGetStaticModuleState：這是一個(gè)函數(shù)，其函數(shù)原型為：



AFX_MODULE_STATE* AFXAPI AfxGetStaticModuleState( );



此函數(shù)在堆棧上構(gòu)造AFX_MODULE_STATE類的實(shí)例pModuleState并對(duì)其賦值后將其返回。在AFX_MODULE_STATE類的構(gòu)造函數(shù)中，該類獲取指向當(dāng)前模塊狀態(tài)的指針并將其存儲(chǔ)在成員變量中，然后將pModuleState設(shè)置為新的有效模塊狀態(tài)。在它的析構(gòu)函數(shù)中，該類將存儲(chǔ)在其成員變量中的指針還原為存貯的前一個(gè)模塊狀態(tài)。



AFX_MANAGE_STATE：這是一個(gè)宏，其原型為：



AFX_MANAGE_STATE( AFX_MODULE_STATE* pModuleState )



該宏用于將pModuleState（指向包含模塊全局?jǐn)?shù)據(jù)也就是模塊狀態(tài)的AFX_MODULE_STATE結(jié)構(gòu)的指針）設(shè)置為當(dāng)前的即時(shí)作用空間中（the remainder of the immediate containing scope）的有效模塊狀態(tài)。在離開(kāi)包含該宏的作用空間時(shí)，前一個(gè)有效的模塊狀態(tài)自動(dòng)還原。



AfxGetResourceHandle：這個(gè)函數(shù)的原型為：



HINSTANCE AfxGetResourceHandle( );



該函數(shù)返回了一個(gè)保存了HINSTANCE類型的、應(yīng)用程序默認(rèn)所加載資源的模塊的句柄。



AfxSetResourceHandle：這個(gè)函數(shù)的原型為：



void AfxSetResourceHandle( HINSTANCE hInstResource );



該函數(shù)將hInstResource所代表的模塊設(shè)置為具有當(dāng)前狀態(tài)的模塊。



通過(guò)使用上述四個(gè)函數(shù)或宏就可以正確的在動(dòng)態(tài)鏈接到MFC的DLL中切換模塊狀態(tài)。接下來(lái)我們將通過(guò)修改上面出現(xiàn)問(wèn)題的那個(gè)例子來(lái)介紹如何使用上述四個(gè)函數(shù)或宏。先來(lái)看看Regular DLL using shared MFC DLL類型：



在上述例子的第三步的ShowDlg函數(shù)的第一條語(yǔ)句前加上如下語(yǔ)句（要確保該語(yǔ)句在函數(shù)實(shí)現(xiàn)的第一行）：



AFX_MANAGE_STATE(AfxGetStaticModuleState());



之后重新編譯生成DLLShared.dll和DLLShared.lib，并將這兩個(gè)文件重新拷貝到Use工程的Debug目錄內(nèi)。這次編譯生成Use.exe并運(yùn)行，點(diǎn)擊按鈕，可以看到彈出的時(shí)我們?cè)贒LL中所加入的那個(gè)對(duì)話框，而不再是Use.exe的關(guān)于對(duì)話框了。



通過(guò)上面的講解，相信你已經(jīng)知道該語(yǔ)句的作用了。在函數(shù)ShowDlg的第一行加上這么一句后，每次調(diào)用DLL的應(yīng)用程序使用該函數(shù)的時(shí)候，MFC庫(kù)都會(huì)自動(dòng)切換當(dāng)前模塊狀態(tài)，這樣就保證了資源讀取的正確性。



AFX_MANAGE_STATE(AfxGetStaticModuleState());是自動(dòng)切換當(dāng)前模塊狀態(tài)，也可以通過(guò)使用AfxGetResourceHandle和AfxSetResourceHandle來(lái)手動(dòng)切換當(dāng)前模塊狀態(tài)。具體使用方法如下：



在上述例子的第三步的ShowDlg函數(shù)的第一條語(yǔ)句前加上如下語(yǔ)句（要確保該語(yǔ)句在函數(shù)實(shí)現(xiàn)的第一行）：



HINSTANCE save_hInstance = AfxGetResourceHandle();

AfxSetResourceHandle(theApp.m_hInstance);



在調(diào)用對(duì)話框成功之后，也就是dlg.DoModal();之后，添加：



AfxSetResourceHandle(save_hInstance);



這種方法在進(jìn)入ShowDlg函數(shù)之后，通過(guò)AfxGetResourceHandle來(lái)獲得并保存當(dāng)前狀態(tài)模塊的句柄。然后獲得DLL模塊的句柄theApp.m_hInstance（當(dāng)然，也可以使用GetModuleHandle函數(shù)來(lái)獲得DLL模塊的句柄），并使用AfxSetResourceHandle函數(shù)來(lái)將其設(shè)置為當(dāng)前狀態(tài)狀態(tài)。最后在調(diào)用對(duì)話框成功之后再用恢復(fù)AfxSetResourceHandle資源句柄，將當(dāng)前模塊狀態(tài)恢復(fù)。



這樣做有些麻煩，但是有一點(diǎn)好處是可以在完成使用資源的任務(wù)之后就可以立即恢復(fù)資源句柄。而AFX_MANAGE_STATE(AfxGetStaticModuleState());的方法只能等函數(shù)的作用空間結(jié)束之后才恢復(fù)資源句柄。由于可執(zhí)行文件必須重畫(huà)工具條等原因，因此建議只要有可能就必須恢復(fù)資源句柄，否則可能會(huì)遇到許多問(wèn)題。比如說(shuō)，如果用戶移動(dòng)DLL的對(duì)話框，而此時(shí)資源句柄仍然為DLL的資源，那么程序就會(huì)崩潰。最好的恢復(fù)句柄的時(shí)機(jī)在對(duì)話框響應(yīng)WM_INITDIALOG消息的時(shí)候，因?yàn)檫@時(shí)對(duì)話框的模板等已經(jīng)讀出了。


對(duì)于MFC Extension DLL(using shared MFC DLL)類型的MFC DLL，切換當(dāng)前模塊狀態(tài)的方法與Regular DLL using shared MFC DLL類型的MFC DLL所使用的方法很相似，這里不再舉例實(shí)現(xiàn)。二者不同的地方如下：



在MFC擴(kuò)展DLL中使用AFX_MANAGE_STATE(AfxGetStaticModuleState());時(shí)，會(huì)產(chǎn)生如下錯(cuò)誤：



mfcs42d.lib(dllmodul.obj) : error LNK2005: __pRawDllMain already defined in dllextend.obj

mfcs42d.lib(dllmodul.obj) : error LNK2005: _DllMain@12 already defined in dllextend.obj

mfcs42d.lib(dllmodul.obj) : error LNK2005: __pRawDllMain already defined in dllextend.obj



因此在MFC擴(kuò)展DLL中需要將AFX_MANAGE_STATE(AfxGetStaticModuleState());換成AFX_MANAGE_STATE(AfxGetAppModuleState());才能正確切換當(dāng)前模塊狀態(tài)。



在MFC擴(kuò)展DLL中使用AfxGetResourceHandle和AfxSetResourceHandle的方法與在Regular DLL using shared MFC DLL類型的MFC DLL中所使用的方法相同。并且，DLL模塊的句柄可以通過(guò)MFC提供的DlgextentDLL這個(gè)結(jié)構(gòu)的hModule成員來(lái)獲得。即使用AfxSetResourceHandle(DlgextentDLL.hModule);語(yǔ)句。



當(dāng)然，對(duì)于動(dòng)態(tài)鏈接到MFC的DLL，也可以在調(diào)用該DLL的MFC應(yīng)用程序中使用AfxGetResourceHandle和AfxSetResourceHandle兩個(gè)函數(shù)來(lái)切換當(dāng)前狀態(tài)模塊。該DLL模塊的句柄可以用GetModuleHandle函數(shù)來(lái)獲得。在此不再贅述。