VC++ MFC DLL 動態連結庫開發完整教學

一、DLL 類型選擇

二、建立與匯出

1. 匯出類別

// 一般 DLL / 擴展 DLL 通用
class __declspec(dllexport) CMyClass { ... };

// 擴展 DLL 專用巨集 (自動處理 dllimport/dllexport)
class AFX_EXT_CLASS CMyClass { ... }

2. 匯出變數/常數/物件

__declspec(dllexport) int g_nValue;
__declspec(dllexport) const COLORREF g_clrRed = RGB(255,0,0); // 常數必須加 extern
__declspec(dllexport) CRect g_rect(10,10,20,20);

每個載入進程擁有獨立副本，修改不影響其他進程。

3. 匯出函數

// 一般 DLL (C 介面)
extern "C" __declspec(dllexport) int MyFunc(int x);

// 動態連結 MFC 一般 DLL 必須加 AFX_MANAGE_STATE
extern "C" __declspec(dllexport) int MyFunc(int x)
{
    AFX_MANAGE_STATE(AfxGetStaticModuleState());
    // MFC 代碼...
}

4. 匯出指標與生命週期管理

__declspec(dllexport) CMyClass* g_pObj = new CMyClass;

// 擴展 DLL: DllMain 清理
BOOL WINAPI DllMain(HINSTANCE hInst, DWORD dwReason, LPVOID)
{
    if (dwReason == DLL_PROCESS_DETACH) delete g_pObj;
    return TRUE;
}

// 一般 DLL: 覆寫 CWinApp::ExitInstance
int CMyDllApp::ExitInstance() { delete g_pObj; return CWinApp::ExitInstance(); }

三、客戶端使用 DLL

1. 複製 .dll、.lib、匯出類別/函數 .h 到客戶專案目錄。
2. 專案設定 → Link → Object/library modules 加入 Debug/MyDll.lib。
3. 標頭檔改為 __declspec(dllimport)：

__declspec(dllimport) int MyFunc(int);
__declspec(dllimport) CMyClass g_obj;
extern "C" __declspec(dllimport) int MyFunc(int);

建議建立共用標頭檔，用巨集切換：

#ifdef MYDLL_EXPORTS
#define MYDLL_API __declspec(dllexport)
#else
#define MYDLL_API __declspec(dllimport)
#endif

class MYDLL_API CMyClass { ... };
MYDLL_API int MyFunc(int);

四、關鍵注意事項

• 版本一致：Debug/Release 不能混用；MFC 連結模式 (靜態/動態) 必須雙方一致。
• CRT 邊界：跨 DLL 邊界傳遞 STL 容器、CString、檔案指標、new/delete 極易崩潰，**嚴禁跨 DLL 釋放對方配置的記憶體**。
• 匯出 C++ 類別：客戶端可直接建立物件、繼承；但類別佈局、虛函數表、RTTI 完全綁定編譯器版本，**僅限同版本 VC++ 使用**。