Jacob 調用 C++ COM 組件 BSTR 參數亂碼問題的編碼解決方案

問題現象

C++ COM 方法簽名：HRESULT sayHello2([in] BSTR say, [out, retval] BSTR* result);
Java 端使用 Jacob 調用 Dispatch.call(disp, "sayHello2", "fuck") 拋出 Can't map name to dispid: sayHello2 或返回亂碼。

原因分析

• 方法名大小寫/映射問題： COM 區分大小寫，確保 IDL 中定義名與調用名完全一致。
• 字符編碼不匹配： Java 默認 UTF-16，C++ BSTR 為 UTF-16，但 Java 字符串獲取字節再構造時若編碼指定錯誤會導致傳遞內容錯誤。
• 線程模型： Jacob 需正確初始化 COM 線程模型（STA/MTA）。

修正代碼示例

ComThread.InitSTA(); // 單線程單元模式，GUI/COM 組件常用
ActiveXComponent com = new ActiveXComponent("CLSID:FF90EFCA-0856-4159-A9CC-0E7BBC317554");
Dispatch disp = (Dispatch) com.getObject();

// 確保字符串以正確編碼傳遞（通常 Jacob 內部處理 Unicode，無需手動轉碼）
// 若遇亂碼，可嘗試顯式指定編碼構造 Variant
Variant input = new Variant("測試字符串"); // 直接傳字符串，Jacob 自動轉 BSTR
Variant result = Dispatch.call(disp, "sayHello2", input);
System.out.println(result.getString()); // 獲取返回 BSTR

關鍵建議

1. 優先使用 ComThread.InitSTA() 而非 MTA，許多 ActiveX/COM 組件要求 STA。
2. 直接傳遞 Java String 或 Variant(String)，讓 Jacob 內部處理 Unicode→BSTR 轉換，避免手動 getBytes() 損壞數據。
3. 使用 OLEView 或 TypeLib 瀏覽器驗證組件的 ProgID/CLSID 和方法簽名大小寫。
4. 若仍報 Can't map name to dispid，嘗試 disp.getIDsOfNames 確認方法名，或調用 Dispatch.callN 忽略大小寫。