ATL COM 服務器開發入門：從向導到客戶端調用全流程

目標讀者與範圍

面向 COM 初學者，演示使用 ATL 向導創建進程內 COM 服務器（DLL），實現簡單雙接口對象，並在 VC++ / VB 客戶端調用。不深入 IDL/COM 理論，重工程步驟。

步驟一：ATL COM AppWizard 創建工程

1. VC++ File → New → Projects，選擇 ATL COM AppWizard。
2. 專案名：Simple_ATL，路徑：E:\Samples\Simple_ATL。

圖一

3. 向導選項：Server Type → Dynamic Link Library (DLL)（進程內服務器必須是 DLL）。其他保持默認，Finish。

圖二

圖三

步驟二：添加 ATL 簡單對象

1. 切換到 ClassView，右鍵專案節點 → Add ATL Object。
2. 選擇 Simple Object，Next。

圖四

3. 屬性頁配置：
   • Short Name：First_ATL（其它自動填充）。
   • Threading Model：Apartment（單元模型，默認）。
   • Interface：Dual（雙接口，支持 IDispatch 晚綁定，適合 VB/腳本調用）。
   • Aggregation：No（不支持聚合）。
4. OK 生成代碼。

// Client.cpp
#import "..\Simple_ATL\Debug\Simple_ATL.tlb" no_namespace

int main()
{
    CoInitialize(NULL);
    IFirst_ATLPtr pObj(__uuidof(First_ATL)); // 智能指針自動管理引用計數
    long result;
    pObj->AddNumbers(10, 20, &result);
    printf("10 + 20 = %d\n", result); // 輸出 30
    CoUninitialize();
    return 0;
}