在 Active Accessibility / COM 自動化中,已取得視窗句柄 → IHTMLDocument2,欲進一步取得 IWebBrowser2 控制瀏覽器行為。直接 QueryInterface 失敗,IHTMLWindow2::get_navigator 也無法取得 IOmNavigator。
COM 規則:QueryInterface 僅詢問「你自己實作哪些介面」。文件、瀏覽器、視窗是**獨立物件**,文件不實作 IWebBrowser2。需透過 IServiceProvider 導航物件層級:
QueryInterface問:「你實作這介面嗎?」
QueryService問:「不管哪個物件實作,幫我找到它。」
// 1. 從文件取得 IServiceProvider
CComQIPtr<IServiceProvider> sp = pIHTMLDocument2;
// 2. 透過服務導航取得瀏覽器應用程式介面
CComQIPtr<IWebBrowser2> wb2;
sp->QueryService(SID_SWebBrowserApp, IID_IWebBrowser2, (void**)&wb2);
// 或
sp->QueryService(IID_IWebBrowserApp, IID_IWebBrowser2, (void**)&wb2);
SID_SWebBrowserApp 定義為 IID_IWebBrowserApp,兩者可互換,但用 SID 較符合語意。
// 從 ActiveX 控制項站點開始
CComQIPtr<IServiceProvider> sp = pSite; // IOleClientSite → IServiceProvider
CComQIPtr<IWebBrowserApp> wba;
sp->QueryService(SID_SWebBrowserApp, IID_IWebBrowserApp, (void**)&wba); // 應用程式層(最上層)
CComQIPtr<IWebBrowser2> wb2;
sp->QueryService(SID_SWebBrowserApp, IID_IWebBrowser2, (void**)&wb2); // 瀏覽器控制介面
+----------------+ IServiceProvider +------------------+
| Document | ───────────────────────→ | WebBrowser2 |
| (IHTMLDoc2) | QueryService(SID, IID) | (實作介面) |
+----------------+ +------------------+
↑ ↑
| 內部指標 | 同一或不同物件
| |
+----------------+ +------------------+
| Window | | Frame/Shell |
| (IHTMLWin2) | | (容器) |
+----------------+ +------------------+
IServiceProviderQueryService 遞歸追蹤內部指標,找到實作目標介面的物件並返回| SID | 對應介面 | 用途 |
|---|---|---|
SID_SWebBrowserApp | IWebBrowserApp / IWebBrowser2 | 瀏覽器應用程式/控制介面 |
SID_SContainerDispatch | IDispatch | 容器自動化介面 |
IID_IHTMLDocument2 | IHTMLDocument2 | 文件介面(也可作 SID) |