在DLL中使用資源（一）
yuwei - 轉(zhuǎn)載 （2004-12-10 14:02:00） .Net控件開發(fā) ActiveX/COM開發(fā) CLX/VCL開發(fā) Java組件開發(fā) VC/MFC 控件使用經(jīng)驗(yàn)談 DHtml/Script 控件開發(fā)基礎(chǔ) 數(shù)據(jù)庫 編程規(guī)范 單元測(cè)試 可重用軟件技術(shù)理論 其 它
在DLL中使用資源（一）
現(xiàn)在最常看見的關(guān)于DLL的問題就是如何在DLL中使用對(duì)話框，這是一個(gè)很普遍的關(guān)于如何在DLL中使用資源的問題。這里我們從Win32 DLL和MFC DLL兩個(gè)方面來分析并解決這個(gè)問題。
1．Win32 DLL
在Win32 DLL中使用對(duì)話框很簡(jiǎn)單，你只需要在你的DLL中添加對(duì)話框資源，而且可以在對(duì)話框上面設(shè)置你所需要的控件。然后使用DialogBox或者CreateDialog這兩個(gè)函數(shù)（或相同作用的其它函數(shù)）來創(chuàng)建對(duì)話框，并定義你自己的對(duì)話框回調(diào)函數(shù)處理對(duì)話框收到的消息。下面通過一個(gè)具體實(shí)例來學(xué)習(xí)如何在Win32 DLL中使用對(duì)話框，可以按照以下步驟來完成這個(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。
接下來我們建立調(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語句后面加上如下代碼：
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)行成功。
讓我們來回顧一下在Win32 DLL中使用對(duì)話框的過程。
在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中，我們使用隱式鏈接的方法來調(diào)用DLL，并使用DLL中導(dǎo)出的ShowDlg函數(shù)來調(diào)用DLL中的對(duì)話框。
在Win32 DLL中使用對(duì)話框就是這么簡(jiǎn)單，下面讓我們來看一下在MFC DLL中如何使用對(duì)話框。
2．MFC DLL
在MFC DLL中使用對(duì)話框不像Win32 DLL中那么簡(jiǎn)單，主要是因?yàn)镸FC程序中存在一個(gè)模塊狀態(tài)（Module State）的問題，也就是資源重復(fù)的問題。（此處的術(shù)語模塊是指一個(gè)可執(zhí)行程序，或指其操作不依賴于應(yīng)用程序的其余部分但使用MFC運(yùn)行庫的共享副本的一個(gè)DLL（或一組DLL）。我們所創(chuàng)建的MFC DLL就是這種模塊的一個(gè)典型實(shí)例。）
在每個(gè)模塊（EXE或DLL）中，都存在一種全局的狀態(tài)數(shù)據(jù)，MFC依靠這種全局的狀態(tài)數(shù)據(jù)來區(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)中，并且總是可以通過指向該結(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庫的鏈接方法，一個(gè)MFC DLL有兩種使用MFC庫的方法：靜態(tài)鏈接到MFC的DLL和動(dòng)態(tài)鏈接到MFC的DLL。下面我們就按照這兩種類型的MFC DLL來介紹如何切換當(dāng)前模塊狀態(tài)以正確的在MFC DLL中使用資源。
1、靜態(tài)鏈接到MFC的DLL
靜態(tài)鏈接到MFC的規(guī)則DLL與MFC庫靜態(tài)鏈接，則此時(shí)MFC庫不能共享，所以MFC總是使用它所鏈接的DLL的模塊狀態(tài)。這樣也就不存在管理模塊狀態(tài)的問題。但使用這種方法的缺點(diǎn)是DLL程序?qū)?huì)變大，而且會(huì)在程序中留下重復(fù)代碼。下面給出的例子驗(yàn)證了這一點(diǎn)。本例可以按照以下步驟來完成：
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語句中添加一行：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ì)話框。說明，當(dāng)使用靜態(tài)鏈接到MFC的規(guī)則DLL時(shí)，不存在管理模塊狀態(tài)的問題。
2、動(dòng)態(tài)鏈接到MFC的DLL
在討論關(guān)于動(dòng)態(tài)鏈接到MFC的DLL的模塊狀態(tài)問題之前，先來看一個(gè)例子。本例可以通過如下步驟來完成：
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語句中添加一行：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ì)，沒錯(cuò)，這次彈出的是Use.exe的關(guān)于對(duì)話框。將上述例子的DLL類型換成MFC Extension DLL(using shared MFC DLL)也會(huì)出現(xiàn)相同的問題。
為什么會(huì)出現(xiàn)上面的問題？這是因?yàn)樵谑褂昧薓FC共享庫的時(shí)候，默認(rèn)情況下，MFC使用主應(yīng)用程序的資源句柄來加載資源模板。雖然我們調(diào)用的是DLL中的函數(shù)來顯示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ì)話框顯示了出來。如果二者不同，則MFC就認(rèn)為DLL中所定義的對(duì)話框資源不存在，dlg.DoModal會(huì)返回0，也就是什么都不會(huì)顯示。
那么如何解決上述問題呢？解決辦法就是在適當(dāng)?shù)臅r(shí)候進(jìn)行模塊狀態(tài)切換，以保證具有當(dāng)前狀態(tài)的模塊是我們所需要的模塊從而使用正確的資源。MFC提供了下列函數(shù)和宏來完成這些工作：
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)。在離開包含該宏的作用空間時(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)的模塊。
通過使用上述四個(gè)函數(shù)或宏就可以正確的在動(dòng)態(tài)鏈接到MFC的DLL中切換模塊狀態(tài)。接下來我們將通過修改上面出現(xiàn)問題的那個(gè)例子來介紹如何使用上述四個(gè)函數(shù)或宏。先來看看Regular DLL using shared MFC DLL類型：
在上述例子的第三步的ShowDlg函數(shù)的第一條語句前加上如下語句（要確保該語句在函數(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ì)話框了。
通過上面的講解，相信你已經(jīng)知道該語句的作用了。在函數(shù)ShowDlg的第一行加上這么一句后，每次調(diào)用DLL的應(yīng)用程序使用該函數(shù)的時(shí)候，MFC庫都會(huì)自動(dòng)切換當(dāng)前模塊狀態(tài)，這樣就保證了資源讀取的正確性。
AFX_MANAGE_STATE(AfxGetStaticModuleState());是自動(dòng)切換當(dāng)前模塊狀態(tài)，也可以通過使用AfxGetResourceHandle和AfxSetResourceHandle來手動(dòng)切換當(dāng)前模塊狀態(tài)。具體使用方法如下：
在上述例子的第三步的ShowDlg函數(shù)的第一條語句前加上如下語句（要確保該語句在函數(shù)實(shí)現(xiàn)的第一行）：
HINSTANCE save_hInstance = AfxGetResourceHandle();
AfxSetResourceHandle(theApp.m_hInstance);
在調(diào)用對(duì)話框成功之后，也就是dlg.DoModal();之后，添加：
AfxSetResourceHandle(save_hInstance);
這種方法在進(jìn)入ShowDlg函數(shù)之后，通過AfxGetResourceHandle來獲得并保存當(dāng)前狀態(tài)模塊的句柄。然后獲得DLL模塊的句柄theApp.m_hInstance（當(dāng)然，也可以使用GetModuleHandle函數(shù)來獲得DLL模塊的句柄），并使用AfxSetResourceHandle函數(shù)來將其設(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í)行文件必須重畫工具條等原因，因此建議只要有可能就必須恢復(fù)資源句柄，否則可能會(huì)遇到許多問題。比如說，如果用戶移動(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模塊的句柄可以通過MFC提供的DlgextentDLL這個(gè)結(jié)構(gòu)的hModule成員來獲得。即使用AfxSetResourceHandle(DlgextentDLL.hModule);語句。
當(dāng)然，對(duì)于動(dòng)態(tài)鏈接到MFC的DLL，也可以在調(diào)用該DLL的MFC應(yīng)用程序中使用AfxGetResourceHandle和AfxSetResourceHandle兩個(gè)函數(shù)來切換當(dāng)前狀態(tài)模塊。該DLL模塊的句柄可以用GetModuleHandle函數(shù)來獲得。在此不再贅述。