【MSDN】使用 __declspec(dllexport) 從 DLL 匯出

Microsoft 在 Visual C++ 的 16 位編譯器版本中引入了 __export，使編譯器得以自動產生匯出名並將它們放到一個 .lib 檔案中。然後，此 .lib 檔案就可以像靜態 .lib 那樣用於與 DLL 連結。

在更新的編譯器版本中，可以使用 __declspec(dllexport) 關鍵字從 DLL 匯出資料、函數、類或類成員函數。__declspec(dllexport) 會將匯出指令添加到對象檔案中，因此您不需要使用 .def 檔案。

當試圖匯出 C++ 修飾函數名時，這種便利最明顯。由於對名稱修飾沒有標準規範，因此匯出函數的名稱在不同的編譯器版本中可能有所變化。如果使用 __declspec(dllexport)，僅當解決任何命名規範更改時才必須重新編譯 DLL 和依賴 .exe 檔。

許多匯出指令（如序號、NONAME 和 PRIVATE）只能在 .def 檔案中建立，並且必須使用 .def 檔案來指定這些屬性。不過，在 .def 檔案的基礎上另外使用 __declspec(dllexport) 不會導致建置錯誤。

若要匯出函數，__declspec(dllexport) 關鍵字必須出現在呼叫慣例關鍵字的左邊（如果指定了關鍵字）。例如：

__declspec(dllexport) void __cdecl Function1(void);

若要匯出類中的所有公用資料成員和成員函數，關鍵字必須出現在類名的左邊，如下所示：

class __declspec(dllexport) CExampleExport : public CObject{ ... class definition ... };

產生 DLL 時，通常建立一個包含正在匯出的函數原型和/或類的標頭檔，並將 __declspec(dllexport) 添加到標頭檔中的聲明中。若要提高代碼的可讀性，請為 __declspec(dllexport)定義一個宏並對正在匯出的每個符號使用該宏：

#define DllExport   __declspec( dllexport ) 

將 DLL 原始碼從 Win16 移植到 Win32 時，請用 __declspec(dllexport) 替換 __export 的每個執行個體。