在DLL中使用資源（一）
yuwei - 轉(zhuǎn)載 （2004-12-10 14:02:00） .Net控件開發(fā) ActiveX/COM開發(fā) CLX/VCL開發(fā) Java組件開發(fā) VC/MFC 控件使用經(jīng)驗談 DHtml/Script 控件開發(fā)基礎(chǔ) 數(shù)據(jù)庫 編程規(guī)范 單元測試 可重用軟件技術(shù)理論 其 它
在DLL中使用資源（一）
現(xiàn)在最常看見的關(guān)于DLL的問題就是如何在DLL中使用對話框，這是一個很普遍的關(guān)于如何在DLL中使用資源的問題。這里我們從Win32 DLL和MFC DLL兩個方面來分析并解決這個問題。
1．Win32 DLL
在Win32 DLL中使用對話框很簡單，你只需要在你的DLL中添加對話框資源，而且可以在對話框上面設(shè)置你所需要的控件。然后使用DialogBox或者CreateDialog這兩個函數(shù)（或相同作用的其它函數(shù)）來創(chuàng)建對話框，并定義你自己的對話框回調(diào)函數(shù)處理對話框收到的消息。下面通過一個具體實例來學(xué)習(xí)如何在Win32 DLL中使用對話框，可以按照以下步驟來完成這個例子：
1）在VC菜單中File->New新建一個命名為UseDlg的Win32 Dynamic-Link Library工程，下一步選擇A simple DLL project。
2）在VC菜單中Insert->Resource添加一個ID為IDD_DLG_SHOW的Dialog資源，將此Dialog上的Cancel按鈕去掉，僅保留OK按鈕。再添加一個ID為IDD_ABOUTBOX的對話框，其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新建一個命名為Use的MFC AppWizard(exe)工程，下一步選擇Dialog Based之后點擊Finish按鈕。
2）在主對話框上面添加一個按鈕，之后雙擊此按鈕，會彈出Add Member Function的對話框，直接點擊OK進入void CUseDlg::OnButton1()函數(shù)。并在此函數(shù)內(nèi)添加一個函數(shù)調(diào)用：ShowDlg();。
3）緊跟在#include語句后面加上如下代碼：
extern "C" __declspec(dllexport) void ShowDlg();
#pragma comment(lib,"debug/UseDlg")
4）將上面UseDlg工程中生成的UseDlg.dll和UseDlg.lib兩個文件復(fù)制到Use工程的Debug目錄內(nèi)。
5）編譯生成Use.exe。
運行Use.exe，點擊Button1按鈕，可以看到一個名稱為Dialog的非模態(tài)對話框彈出。點擊上面的按鈕，可以彈出模態(tài)對話框About。運行成功。
讓我們來回顧一下在Win32 DLL中使用對話框的過程。
在DLL中，我們定義了兩個對話框資源：IDD_DLG_SHOW和IDD_ABOUTBOX，并且導(dǎo)出了函數(shù)ShowDlg。在函數(shù)ShowDlg之中使用CreateDialog函數(shù)創(chuàng)建了非模態(tài)對話框IDD_DLG_SHOW，并指定了該對話框的回調(diào)函數(shù)DlgProc。在DlgProc之中處理了WM_INITDIALOG、WM_COMMAND和WM_CLOSE消息，以響應(yīng)用戶對對話框所做的動作。在處理按鈕動作的時候，使用DialogBox函數(shù)創(chuàng)建IDD_ABOUTBOX這個模態(tài)對話框，指定其回調(diào)函數(shù)為AboutProc，并且在AboutProc中處理其相應(yīng)消息。
在EXE中，我們使用隱式鏈接的方法來調(diào)用DLL，并使用DLL中導(dǎo)出的ShowDlg函數(shù)來調(diào)用DLL中的對話框。
在Win32 DLL中使用對話框就是這么簡單，下面讓我們來看一下在MFC DLL中如何使用對話框。
2．MFC DLL
在MFC DLL中使用對話框不像Win32 DLL中那么簡單，主要是因為MFC程序中存在一個模塊狀態(tài)（Module State）的問題，也就是資源重復(fù)的問題。（此處的術(shù)語模塊是指一個可執(zhí)行程序，或指其操作不依賴于應(yīng)用程序的其余部分但使用MFC運行庫的共享副本的一個DLL（或一組DLL）。我們所創(chuàng)建的MFC DLL就是這種模塊的一個典型實例。）
在每個模塊（EXE或DLL）中，都存在一種全局的狀態(tài)數(shù)據(jù)，MFC依靠這種全局的狀態(tài)數(shù)據(jù)來區(qū)分不同的模塊，以執(zhí)行正確的操作。這種數(shù)據(jù)包括：Windows實例句柄（用于加載資源），指向應(yīng)用程序當(dāng)前的CWinApp和CWinThread對象的指針，OLE模塊引用計數(shù)，以及維護Windows對象句柄與相應(yīng)的MFC對象實例之間連接的各種映射等。但當(dāng)應(yīng)用程序使用多個模塊時，每個模塊的狀態(tài)數(shù)據(jù)不是應(yīng)用程序范圍的。相反，每個模塊具有自已的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í)行時進入了某一個模塊時，只有此模塊的狀態(tài)為“當(dāng)前”或“有效”狀態(tài)時，MFC才能正確的區(qū)分此模塊并執(zhí)行正確的操作。
例如，MFC應(yīng)用程序可以使用下面代碼從資源文件中加載字符串：
CString str;
str.LoadString(IDS_MYSTRING);
使用這種代碼非常方便，但它掩蓋了這樣一個事實：即此程序中IDS_MYSTRING可能不是唯一的標(biāo)識符。一個程序可以加載多個DLL，某些DLL可能也用IDS_MYSTRING標(biāo)識符定義了一個資源。MFC怎樣知道應(yīng)該加載哪個資源呢？MFC使用當(dāng)前模塊狀態(tài)查找資源句柄。如果當(dāng)前模塊不是我們要使用的正確模塊，那么就會產(chǎn)生不正確的調(diào)用或者錯誤。
按照MFC庫的鏈接方法，一個MFC DLL有兩種使用MFC庫的方法：靜態(tài)鏈接到MFC的DLL和動態(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)鏈接，則此時MFC庫不能共享，所以MFC總是使用它所鏈接的DLL的模塊狀態(tài)。這樣也就不存在管理模塊狀態(tài)的問題。但使用這種方法的缺點是DLL程序?qū)兇螅視诔绦蛑辛粝轮貜?fù)代碼。下面給出的例子驗證了這一點。本例可以按照以下步驟來完成：
1）在VC菜單中File->New新建一個命名為DLLStatic的MFC AppWizard的工程，下一步選擇Regular DLL with MFC statically linked。
2）在工程中添加一個對話框資源，其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兩個文件復(fù)制到工程的Debug目錄內(nèi)，并將
extern "C" __declspec(dllexport) void ShowDlg();
#pragma comment(lib,"debug/UseDlg")
這兩行改為：
void ShowDlg();
#pragma comment(lib,"debug/DLLStatic")
編譯并運行Use.exe。點擊按鈕，可以看到DLLStatic中的模態(tài)對話框彈出。
本例中，可以注意到DLL中所定義的About對話框資源與EXE中所定義的About對話框資源ID完全相同，但是當(dāng)我們點擊Use.exe上面的按鈕時，彈出的是DLL中的模態(tài)對話框。說明，當(dāng)使用靜態(tài)鏈接到MFC的規(guī)則DLL時，不存在管理模塊狀態(tài)的問題。
2、動態(tài)鏈接到MFC的DLL
在討論關(guān)于動態(tài)鏈接到MFC的DLL的模塊狀態(tài)問題之前，先來看一個例子。本例可以通過如下步驟來完成：
1）在VC菜單中File->New新建一個命名為DLLShared的MFC AppWizard的工程，下一步選擇Regular DLL using shared MFC DLL。
2）在工程中添加一個對話框資源，其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兩個文件復(fù)制到工程的Debug目錄內(nèi)，并將
extern "C" __declspec(dllexport) void ShowDlg();
#pragma comment(lib,"debug/DLLStatic")
這兩行改為：
void ShowDlg();
#pragma comment(lib,"debug/DLLShared")
編譯并運行Use.exe。點擊按鈕，這次你看到了什么？對，沒錯，這次彈出的是Use.exe的關(guān)于對話框。將上述例子的DLL類型換成MFC Extension DLL(using shared MFC DLL)也會出現(xiàn)相同的問題。
為什么會出現(xiàn)上面的問題？這是因為在使用了MFC共享庫的時候，默認情況下，MFC使用主應(yīng)用程序的資源句柄來加載資源模板。雖然我們調(diào)用的是DLL中的函數(shù)來顯示DLL中的對話框，并且對應(yīng)的對話框模板是存儲在DLL中的，但MFC仍舊在主應(yīng)用程序也就是Use.exe中尋找相應(yīng)的對話框模板。由于在DLL中所定義的對話框資源ID與主應(yīng)用程序中所定義的關(guān)于對話框的資源ID相同，所以MFC就把主應(yīng)用程序中的關(guān)于對話框顯示了出來。如果二者不同，則MFC就認為DLL中所定義的對話框資源不存在，dlg.DoModal會返回0，也就是什么都不會顯示。
那么如何解決上述問題呢？解決辦法就是在適當(dāng)?shù)臅r候進行模塊狀態(tài)切換，以保證具有當(dāng)前狀態(tài)的模塊是我們所需要的模塊從而使用正確的資源。MFC提供了下列函數(shù)和宏來完成這些工作：
AfxGetStaticModuleState：這是一個函數(shù)，其函數(shù)原型為：
AFX_MODULE_STATE* AFXAPI AfxGetStaticModuleState( );
此函數(shù)在堆棧上構(gòu)造AFX_MODULE_STATE類的實例pModuleState并對其賦值后將其返回。在AFX_MODULE_STATE類的構(gòu)造函數(shù)中，該類獲取指向當(dāng)前模塊狀態(tài)的指針并將其存儲在成員變量中，然后將pModuleState設(shè)置為新的有效模塊狀態(tài)。在它的析構(gòu)函數(shù)中，該類將存儲在其成員變量中的指針還原為存貯的前一個模塊狀態(tài)。
AFX_MANAGE_STATE：這是一個宏，其原型為：
AFX_MANAGE_STATE( AFX_MODULE_STATE* pModuleState )
該宏用于將pModuleState（指向包含模塊全局?jǐn)?shù)據(jù)也就是模塊狀態(tài)的AFX_MODULE_STATE結(jié)構(gòu)的指針）設(shè)置為當(dāng)前的即時作用空間中（the remainder of the immediate containing scope）的有效模塊狀態(tài)。在離開包含該宏的作用空間時，前一個有效的模塊狀態(tài)自動還原。
AfxGetResourceHandle：這個函數(shù)的原型為：
HINSTANCE AfxGetResourceHandle( );
該函數(shù)返回了一個保存了HINSTANCE類型的、應(yīng)用程序默認所加載資源的模塊的句柄。
AfxSetResourceHandle：這個函數(shù)的原型為：
void AfxSetResourceHandle( HINSTANCE hInstResource );
該函數(shù)將hInstResource所代表的模塊設(shè)置為具有當(dāng)前狀態(tài)的模塊。
通過使用上述四個函數(shù)或宏就可以正確的在動態(tài)鏈接到MFC的DLL中切換模塊狀態(tài)。接下來我們將通過修改上面出現(xiàn)問題的那個例子來介紹如何使用上述四個函數(shù)或宏。先來看看Regular DLL using shared MFC DLL類型：
在上述例子的第三步的ShowDlg函數(shù)的第一條語句前加上如下語句（要確保該語句在函數(shù)實現(xiàn)的第一行）：
AFX_MANAGE_STATE(AfxGetStaticModuleState());
之后重新編譯生成DLLShared.dll和DLLShared.lib，并將這兩個文件重新拷貝到Use工程的Debug目錄內(nèi)。這次編譯生成Use.exe并運行，點擊按鈕，可以看到彈出的時我們在DLL中所加入的那個對話框，而不再是Use.exe的關(guān)于對話框了。
通過上面的講解，相信你已經(jīng)知道該語句的作用了。在函數(shù)ShowDlg的第一行加上這么一句后，每次調(diào)用DLL的應(yīng)用程序使用該函數(shù)的時候，MFC庫都會自動切換當(dāng)前模塊狀態(tài)，這樣就保證了資源讀取的正確性。
AFX_MANAGE_STATE(AfxGetStaticModuleState());是自動切換當(dāng)前模塊狀態(tài)，也可以通過使用AfxGetResourceHandle和AfxSetResourceHandle來手動切換當(dāng)前模塊狀態(tài)。具體使用方法如下：
在上述例子的第三步的ShowDlg函數(shù)的第一條語句前加上如下語句（要確保該語句在函數(shù)實現(xiàn)的第一行）：
HINSTANCE save_hInstance = AfxGetResourceHandle();
AfxSetResourceHandle(theApp.m_hInstance);
在調(diào)用對話框成功之后，也就是dlg.DoModal();之后，添加：
AfxSetResourceHandle(save_hInstance);
這種方法在進入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)用對話框成功之后再用恢復(fù)AfxSetResourceHandle資源句柄，將當(dāng)前模塊狀態(tài)恢復(fù)。
這樣做有些麻煩，但是有一點好處是可以在完成使用資源的任務(wù)之后就可以立即恢復(fù)資源句柄。而AFX_MANAGE_STATE(AfxGetStaticModuleState());的方法只能等函數(shù)的作用空間結(jié)束之后才恢復(fù)資源句柄。由于可執(zhí)行文件必須重畫工具條等原因，因此建議只要有可能就必須恢復(fù)資源句柄，否則可能會遇到許多問題。比如說，如果用戶移動DLL的對話框，而此時資源句柄仍然為DLL的資源，那么程序就會崩潰。最好的恢復(fù)句柄的時機在對話框響應(yīng)WM_INITDIALOG消息的時候，因為這時對話框的模板等已經(jīng)讀出了。
對于MFC Extension DLL(using shared MFC DLL)類型的MFC DLL，切換當(dāng)前模塊狀態(tài)的方法與Regular DLL using shared MFC DLL類型的MFC DLL所使用的方法很相似，這里不再舉例實現(xiàn)。二者不同的地方如下：
在MFC擴展DLL中使用AFX_MANAGE_STATE(AfxGetStaticModuleState());時，會產(chǎn)生如下錯誤：
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擴展DLL中需要將AFX_MANAGE_STATE(AfxGetStaticModuleState());換成AFX_MANAGE_STATE(AfxGetAppModuleState());才能正確切換當(dāng)前模塊狀態(tài)。
在MFC擴展DLL中使用AfxGetResourceHandle和AfxSetResourceHandle的方法與在Regular DLL using shared MFC DLL類型的MFC DLL中所使用的方法相同。并且，DLL模塊的句柄可以通過MFC提供的DlgextentDLL這個結(jié)構(gòu)的hModule成員來獲得。即使用AfxSetResourceHandle(DlgextentDLL.hModule);語句。
當(dāng)然，對于動態(tài)鏈接到MFC的DLL，也可以在調(diào)用該DLL的MFC應(yīng)用程序中使用AfxGetResourceHandle和AfxSetResourceHandle兩個函數(shù)來切換當(dāng)前狀態(tài)模塊。該DLL模塊的句柄可以用GetModuleHandle函數(shù)來獲得。在此不再贅述。