COM 智慧指標完全指南：CComPtr、CComQIPtr 原理、用法與釋放陷阱避坑

COM 介面指標需手動 AddRef/Release，極易洩漏或重複釋放導致崩潰。智慧指標以 RAII 封裝管理參考計數，本文解析原理、自製範例、ATL 兩大智慧指標用法與關鍵陷阱。

智慧指標核心原理

• 重載 operator->() 轉發呼叫給內部原始指標。
• 建構/複製時 AddRef，解構/賦值時 Release，引用計數歸零自動 delete 內部物件。
• 屬於代理模式應用。

自製智慧指標教學範例

template<class T>
class JTSmartPointer {
    T *m_pData;
    RefCount *m_pRef;  // 參考計數器（執行緒安全）
public:
    JTSmartPointer(T *p) : m_pData(p), m_pRef(new RefCount) { m_pRef->AddRef(); }
    JTSmartPointer(const JTSmartPointer& sp) : m_pData(sp.m_pData), m_pRef(sp.m_pRef) { m_pRef->AddRef(); }
    ~JTSmartPointer() { if (m_pRef && m_pRef->Release() == 0) { delete m_pRef; delete m_pData; } }
    T& operator*() { return *m_pData; }
    T* operator->() { return m_pData; }
    JTSmartPointer& operator=(const JTSmartPointer& sp) { /* 處理自賦值、釋放舊、接管新、AddRef */ }
    JTSmartPointer& operator=(T *p) { /* 釋放舊、接管新裸指標、新 RefCount */ }
};

ATL 智慧指標：CComPtr vs CComQIPtr

常用操作速查

CComQIPtr<IFun> spFun;                    // 空指標
CComQIPtr<IFun> spFun(pOtherIF);           // 建構時自動 QI
CComQIPtr<IFun> spFun(pUnknown);           // 從 IUnknown QI
spFun = pOtherInterface;                   // 賦值自動 QI
spFun.CoCreateInstance(CLSID_X);           // 建立並 QI
if (spFun) { ... }                         // 判斷有效性
spFun->SomeMethod();                       // 呼叫介面方法
spFun.Release();                           // 正確釋放：內部 Release + 歸零
// spFun->Release();  // ❌ 絕對禁止！導致智慧指標內部指標成懸空野指標

關鍵陷阱總結

1. 絕不呼叫 sp->Release()：繞過智慧指標管理，造成雙重釋放或野指標。
2. 函式參數傳遞智慧指標時，優先用 const 參考（void Func(const CComPtr<IFoo>& sp)），避免觸發複製建構/賦值導致額外 AddRef/Release。
3. 若需傳遞給要求裸指標的 API，使用 sp.p 或 &sp.p（輸出參數）。
4. CComQIPtr 無法直接定義 IUnknown*，需顯式模板參數指定 IID。

實務心得

「不想犧牲周末除崩潰，請無腦使用智慧指標。」—— 血淚經驗之談

全專案強制使用 CComPtr/CComQIPtr 管理介面指標，配合靜態分析工具檢查裸指標殘留，可消除 90% 以上 COM 記憶體/崩潰問題。

1. 上一篇文章： COM 進程外伺服器（EXE）架構詳解：LPC、封送、Proxy/Stub 與客戶端透明性
2. 下一篇文章： C++ 設計模式：觀察者模式完整解析與 Excel 圖表自動更新實例

關於C語言

資料結構教科書演算法實作：費波那契搜尋（Fibonacci Search）完整原始碼與測試

資料結構教科書演算法實作：費波那契搜尋（Fibonacci

C 語言隨機數生成陷阱與正確姿勢：srand 與 time 種子機制詳解

C 語言隨機數生成陷阱與正確姿勢：srand 與 time

C語言指標長度與類型深度解析：size_t、ptrdiff_t、intptr_t 完全指南

前言 在C語言程式設計中，指標的長度與類型是跨平台移植與系統

多執行緒在 Visual C# 網路程式設計中的應用（三）：單執行緒掃描器實作與效能基準

Form1.cs 命名空間引入 using System;