COM 自動化與調度介面完整解析：IDispatch、雙重介面、類型庫與 Invoke 參數詳解

自動化讓解釋性語言（VBScript、JavaScript）與巨集語言能輕鬆存取 COM 元件。本文深入剖析 IDispatch 介面、調度介面、雙重介面、Invoke 七大參數、屬性與方法對應、類型庫機制與實務呼叫範例。

IDispatch 介面定義

interface IDispatch : IUnknown {
    HRESULT GetTypeInfoCount(UINT *pctinfo);
    HRESULT GetTypeInfo(UINT iTInfo, LCID lcid, ITypeInfo **ppTInfo);
    HRESULT GetIDsOfNames(REFIID riid, OLECHAR **rgszNames, UINT cNames, LCID lcid, DISPID *rgDispId);
    HRESULT Invoke(DISPID dispIdMember, REFIID riid, LCID lcid, WORD wFlags,
                   DISPPARAMS *pDispParams, VARIANT *pVarResult,
                   EXCEPINFO *pExcepInfo, UINT *puArgErr);
};

核心雙函式：GetIDsOfNames（名稱→DISPID）、Invoke（DISPID→執行）。

調度介面與雙重介面

• 調度介面：Invoke 實作的一組函式集合，非 vtable 佈局。
• 雙重介面：繼承 IDispatch 的 COM 介面，成員同時可透過 vtable（早期繫結）與 Invoke（晚期繫結）存取。C++ 用 vtable 高效，腳本語言用 Invoke 彈性。

IDispatch 呼叫三步驟

1. 取得元件 IDispatch 介面指標（CoCreateInstance + IID_IDispatch）。
2. 呼叫 GetIDsOfNames 取得目標函式/屬性的 DISPID。
3. 構造 DISPPARAMS，呼叫 Invoke 執行。

Invoke 七大參數深度解析

IDL 中屬性定義與 wFlags 對應

[propput] HRESULT Visible([in] VARIANT_BOOL bVisible);
[propget] HRESULT Visible([out, retval] VARIANT_BOOL *pbVisible);

• MIDL 產生 put_Visible、get_Visible，同一 DISPID。
• Invoke 以 wFlags 區分：PROPERTYPUT 呼叫 put、PROPERTYGET 呼叫 get。

類型庫

• IDL 編譯產物（.tlb），含元件/介面/方法/屬性/參數/結構的完整型別資訊。
• 可獨立發布（regtlib 註冊）或嵌入 DLL/EXE 資源。
• C++ 客戶端用 #import "xxx.tlb" no_namespace 產生 .tlh/.tli 標頭，實現早期繫結與智慧提示。

實務建議

• 純 C/C++ 客戶端 → 直接用 vtable 介面（效能最佳）。
• 需支援 VB/JS/腳本語言 → 實作雙重介面（dual 介面）。
• 永遠優先使用類型庫（#import），避免手工構造 DISPPARAMS 易錯。