如何使用BHO定制你的Internet Explorer瀏覽器

原文：微軟公司 Dino Esposito
編譯：朱先中

原文出處：Browser Helper Objects: The Browser the Way You Want It

一、簡介
有時，你可能需要一個定制版本的瀏覽器。在這種情況下，你可以自由地把一些新穎但又不標準的特征增加到一個瀏覽器上。結(jié)果，你最終有的只是一個新但不 標準的瀏覽器。Web瀏覽器控件只是瀏覽器的分析引擎。這意味著仍然存在若干的與用戶接口相關(guān)的工作等待你做――增加一個地址欄，工具欄，歷史記錄，狀態(tài) 欄，頻道欄和收藏夾等。如此，要產(chǎn)生一個定制的瀏覽器，你可以進行兩種類型的編程――一種象微軟把Web瀏覽器控件轉(zhuǎn)變成一個功能齊全的瀏覽器如 Internet Explorer；一種是在現(xiàn)有的基礎(chǔ)上加一些新的功能。如果有一個直接的方法定制現(xiàn)有的Internet Explorer該多好？BHO（Browser Helper Objects，我譯為"瀏覽器幫助者對象"，以下皆簡稱BHO）正是用來實現(xiàn)此目的的。

二、關(guān)于軟件定制
以前，定制一個軟件的行為主要是通過子類化方法實現(xiàn)的。 通過這種辦法，你可以改變一個窗口的外表與行為。子類化雖然被認為是一種有點暴力方式――受害者根本不知道發(fā)生的事情――但它還是長時間以來的唯一的選擇。
隨著微軟Win32 API的到來，進程間子類化不再被鼓勵使用并愈發(fā)變得困難起來。當然，如果你是勇敢的--指針從未嚇倒你，而最重要的是，如果你已經(jīng)游刃于系統(tǒng)鉤子之間，你可能覺得這一問題太簡單了。 但是情形并不總是這樣。暫放下這點不管，問題在于每一個進程運行在自己的地址空間中，而且打破進程邊界略微有些不正確性。 另一方面， 你可能需要對定制進行更好的管理。更經(jīng)常情況下，定制可能是程序本身強烈要求實現(xiàn)的。
在后者情況下，已安裝的軟件只需在既定的磁盤位置查詢另外的組件模塊，然后裝載、設(shè)定初值，最后讓它們自由地按照既定的設(shè)計工作。這正是Internet Explorer瀏覽器和它的BHO所要實現(xiàn)的。

三、什么是BHO?
從某種觀點看，Internet Explorer同普通的Win32程序沒有什么兩樣。借助于BHO，你可以寫一個進程內(nèi)COM對象，這個對象在每次啟動時都要加載。這樣的對象會在與瀏 覽器相同的上下文中運行，并能對可用的窗口和模塊執(zhí)行任何行動。例如，一個BHO能夠探測到典型的事件，如GoBack、GoForward、 DocumentComplete等；另外BHO能夠存取瀏覽器的菜單與工具欄并能做出修改，還能夠產(chǎn)生新窗口來顯示當前網(wǎng)頁的一些額外信息，還能夠安裝 鉤子以監(jiān)控一些消息和動作。簡而言之， BHO的工作如我們打入瀏覽器領(lǐng)地的一位間諜（注意這是微軟允許的合法工作）。
在進一步了解BHO細節(jié)之前，有幾點我需要進一步闡述。首先，BHO對象依托于瀏覽器主窗口。實際上，這意味著一旦一個瀏覽器窗口產(chǎn)生，一個新的BHO對象實例就要生成。任何 BHO對象與瀏覽器實例的生命周期是一致的。其次， BHO僅存在于Internet Explorer 4.0及以后版本中。
如果你在使用Microsoft Windows? 98， Windows 2000， Windows 95， or Windows NT版本4.0 操作系統(tǒng)的話，也就一塊運行了活動桌面外殼4.71，BHO也被 Windows資源管理器所支持。 BHO是一個COM進程內(nèi)服務，注冊于注冊表中某一鍵下。在啟動時，Internet Explorer查詢那個鍵并把該鍵下的所有對象預以加載。
Internet Explorer瀏覽器初始化這一對象并要求某一接口功能。如果發(fā)現(xiàn)這一接口， Internet Explorer使用其提供的方法傳遞 IUnknown 指針到BHO對象。見圖一：


圖一 ie瀏覽器如何裝入和初始化BHO對象，BHO場所（site）是用于實現(xiàn)通信的COM接口

瀏覽器可能在注冊表中發(fā)現(xiàn)一系列的CLSID，并由此為每個CLSID建立一個進程中實例。結(jié)果是，這些對象被裝載至瀏覽器上下文中并運行起來，好象 它們是本地組件一樣。但是，由于Internet Explorer的COM特性，即使被裝入到它的進程空間中于事（你的野心實現(xiàn)）也不一定會有多大幫助。用另一說法， BHO的確能夠做許多潛在的有用的事情，如子類化組成窗口或者安裝線程局部鉤子，但是它確實遠離瀏覽器的核心活動。為了鉤住瀏覽器的事件或者自動化瀏覽 器，BHO需要建立一個私有的基于COM的通訊通道。為此，該BHO應該實現(xiàn)一個稱為IObjectWithSite的接口。事實上，通過接口 IobjectWithSite， Internet Explorer 可以傳遞它的IUnknown 接口。BHO反過來能夠存儲該接口并進一步查詢更專門的接口，如IWebBrowser2、IDispatch和 IConnectionPointContainer。
　　另外一種分析BHO對象的途徑與Internet Explorer外殼擴展有關(guān)。我們知道，一個WINDOWS外殼擴展即是一個進程內(nèi)的COM服務器，它在Windows資源管理器執(zhí)行某種動作時裝入內(nèi) 存――如顯示上下文菜單。通過建立一個實現(xiàn)幾個COM接口的COM模塊，你就給上下文菜單加上一些項并能預以正確處理。一個外殼擴展必須以Windows 資源管理器能夠發(fā)現(xiàn)的方法注冊。一個BHO對象遵循同樣的模式――唯一的改變在于要實現(xiàn)的接口。然而，盡管實現(xiàn)方式有所不同，外殼擴展與 BHO 仍有許多共同的特點。如下表一：

表一 外殼擴展與 BHO相近特性比較

如果你對SHELL擴展編程有興趣的話，可以參考MSDN有關(guān)資料。

四、BHO的生存周期
前面已經(jīng)說過，BHO不僅僅為Internet Explorer所支持。如果你在使用外殼 4.71或者更高版本，你的BHO對象也會被Windows資源管理器所加載。下表二展示了我們可以使用的不同版本的外殼產(chǎn)品情況，Windows外殼版 本號存于庫文件shell32.dll中。

表二 不同版本的Windows外殼對于BHO的支持情況

BHO對象隨著瀏覽器主窗口的顯示而裝入，隨著瀏覽器主窗口的銷毀而缷載。如果你打開多個瀏覽器窗口，多個BHO實例也一同產(chǎn)生。
無論瀏覽器以什么樣的命令行啟動，BHO對象都被加載。舉例來說，即使你只是想要見到特定的 HTML 頁或一個給定的文件夾，BHO對象也被加載。一般地，當 explorer.exe 或 iexplore.exe 運行的時候，BHO都要被考慮在內(nèi)。如果你設(shè)置了"Open each folder in its own window"（對每一個文件夾以一個獨立窗口打開）文件夾選項，那么你每次打開一個文件夾，BHO對象都要被加載。見圖二。


圖二 經(jīng)過這樣設(shè)置，你每次打開一個文件夾時，執(zhí)行一個獨立的explorer.exe實例，并裝入已注冊的BHO對象。

但是注意，這種情形僅適于當你從桌面上的"我的電腦"圖標中打開文件夾的情況。在這種情況下，每次你移到另外一個文件夾時外殼都要調(diào)用 explorer.exe。這種情況在你同時用兩個窗格進行瀏覽時是不會發(fā)生的。事實上，當你改變文件夾時，外殼是不會啟動瀏覽器的新的實例的而僅是簡單 創(chuàng)建嵌入視圖對象的另外一個實例。奇怪的是，如果你在地址欄中輸入一個新的名字來改變文件夾時，在同一個窗口中同樣可以達到瀏覽之目的，無論 Windows資源管理器視圖是單個的還是雙視圖形式。
對于Internet Explorer的情形，事情要更簡單一些。只有你顯式地多次運行iexplore.exe瀏覽器時，你才有多個Internet Explorer的拷貝。當你從Internet Explorer中打開新的窗口時，每一個窗口在一個新的線程中被復制而不是創(chuàng)建一個新的進程，因此也就不需要重新載入BHO對象。
首先，BHO最有趣的地方是，它是極度動態(tài)的。每次Windows資源管理器或者Internet Explorer打開，裝載器從注冊表中讀取已安裝的BHO對象的CLSID然后處理它們。如果你在打開的瀏覽器多個實例中間編輯注冊表的話，你可以隨著 多個瀏覽器拷貝的載入而裝入多個不同的BHO。 這就是說，如果你選擇從頭創(chuàng)建一個新的屬于自己的瀏覽器，那么你可以把它內(nèi)嵌在一個Visual Basic或者MFC框架窗口中。同時你有相當?shù)臋C會來靈活安排瀏覽程序。如果它們能滿足你的需要的話，你可以依賴于Internet Explorer的強大的功能并且加上你想要的盡可能多的插件。

五、關(guān)于IObjectWithSite接口
從一個高起點來看，BHO即是一個DLL，它能夠依附于Internet Explorer瀏覽器的一個新建的實例，在某些情況下也適用于Windows資源管理器。
一般地，一個場所（site）是一個中間對象，它位于容器對象與被包容對象之間。通過它，容器對象管理被包容對象的內(nèi)容，也因此使得對象的內(nèi)部功能可用。為此，容器方要實現(xiàn)接口IoleClientSite，被包容對象要實現(xiàn)接口IOleObject 。通過調(diào)用IOleObject提供的方法，容器對象使得被包容對象清楚地了解其HOST的環(huán)境。
一旦容器對象成為Internet Explorer（或是具有WEB能力的Windows資源管理器），被包容對象只需實現(xiàn)一個輕型的IObjectWithSite接口。該接口提供了以下方法：

表三 IObjectWithSite定義

對BHO 的唯一嚴格的要求正在于必須實現(xiàn)這一個接口。 注意你應該避免在調(diào)用以上任何一個函數(shù)時返回E_NOTIMPL 。 要么你不實現(xiàn)這一接口，要么應保證在調(diào)用這些方法時進行正確地編碼。

六、構(gòu)造自己的BHO對象
一個BHO對象就是一個進程中服務器DLL，選用ATL創(chuàng)建它是再恰當不過的了。我們選擇ATL的另外一個原因是因為它已經(jīng)提供了缺省的而且提供了IObjectWithSite接口的足夠好的實現(xiàn)。另外，在ATL COM 向?qū)П镜刂С值囊讯x好的對象類型當中，有一個，就是Internet Explorer對象，這正是一個BHO應該具有的類型。一個 ATL Internet Explorer 對象，事實上是一個簡單對象――也就是說，是一個支持IUnknown和自注冊，還有接口IObjectWithSite的COM 服務器。如果你在ATL工程中添加一個這樣的對象，并調(diào)用相應的類CViewSource，你將從向?qū)е械玫较铝写a：

class ATL_NO_VTABLE CViewSource :
public CComObjectRootEx<CComSingleThreadModel>，
public CComCoClass<CViewSource， &CLSID_ViewSource>，
public IObjectWithSiteImpl<CViewSource>，
public IDispatchImpl<IViewSource， &IID_IViewSource，
&LIBID_HTMLEDITLib>      

1. 探測誰在裝入這個對象，是Internet Explorer還是Windows資源管理器；
2. 獲取接口IWebBrowser2以實現(xiàn)Web瀏覽器對象；
3. 捕捉Web瀏覽器的特定事件；
4. 存取當前文檔對象，確定它是一份HTML類型的文件；
5. 管理對話框窗口以實現(xiàn)HTML源碼的顯示；

　　第一個步驟是在DllMain()中完成的。SetSite()是取得指向WebBrowser對象指針的適當位置。請詳細分析以下步驟。

七、探測誰在調(diào)用這個對象
如前所述，一個BHO對象會被Internet Explorer或者Windows資源管理器（前提：外殼版本4.71或者更高）所加載。所以我專門設(shè)計了一個BHO來處理HTML網(wǎng)頁，因此這個 BHO與資源管理器毫無關(guān)系。如果一個Dll不想被調(diào)用者一起加載，只需在DllMain()中實現(xiàn)了探明誰在調(diào)用該對象后返回FALSE即可。參看下面 代碼：

if (dwReason == DLL_PROCESS_ATTACH)
{
TCHAR pszLoader[MAX_PATH];
//返回調(diào)用者模塊的名稱，第一個參數(shù)應為NULL，詳見msdn。
GetModuleFileName(NULL， pszLoader， MAX_PATH);
_tcslwr(pszLoader);
if (_tcsstr(pszLoader， _T("explorer.exe")))
return FALSE;
}

if (!_tcsstr(pszLoader， _T("iexplore.exe")))

CComQIPtr< IWebBrowser2， &IID_IWebBrowser2> m_spWebBrowser2;
CComQIPtr<IConnectionPointContainer，
&IID_IConnectionPointContainer> m_spCPC;

HRESULT CViewSource::SetSite(IUnknown *pUnkSite)
{
// 檢索并存儲 IWebBrowser2 指針
m_spWebBrowser2 = pUnkSite;
if (m_spWebBrowser2 == NULL)
return E_INVALIDARG;
//檢索并存儲 IConnectionPointerContainer指針
m_spCPC = m_spWebBrowser2;
if (m_spCPC == NULL)
return E_POINTER;
//檢索并存儲瀏覽器的句柄HWND. 并且安裝一個鍵盤鉤子備后用
RetrieveBrowserWindow();
// 為接受事件通知連接到容器
return Connect();
}

HRESULT CViewSource::Connect(void)
{
HRESULT hr;
CComPtr<IConnectionPoint> spCP;
//為Web瀏覽器事件而接收（receive）連接點
hr = m_spCPC->FindConnectionPoint(DIID_DWebBrowserEvent2， &spCP);
if (FAILED(hr))
return hr;
// 把事件處理器傳遞到容器。每次事件發(fā)生容器都將激活我們實現(xiàn)的IDispatch接口上的相應的函數(shù)。
hr = spCP->Advise( reinterpret_cast<IDispatch*>(this)， &m_dwCookie);
return hr;
}

HRESULT CViewSource::Invoke(DISPID dispidMember， REFIID riid，
LCID lcid， WORD wFlags， DISPPARAMS* pDispParams，
VARIANT* pvarResult， EXCEPINFO* pExcepInfo， UINT* puArgErr)
{
if (dispidMember == DISPID_DOCUMENTCOMPLETE) {
OnDocumentComplete();
m_bDocumentCompleted = true;
}
:
}

CComPtr<IDispatch> pDisp;
HRESULT hr = m_spWebBrowser2->get_Document(&pDisp);

Dim doc As Object
Set doc = WebBrowser1.Document
If TypeName(doc)="HTMLDocument" Then
'' 獲取文檔內(nèi)容并予以顯示
Else
'' Disable the display dialog
End If

CComPtr<IDispatch> pDisp;
HRESULT hr = m_spWebBrowser2->get_Document(&pDisp);
CComQIPtr<IHTMLDocument2， &IID_IHTMLDocument2> spHTML;
spHTML = pDisp;
if (spHTML) {
// 獲取文檔內(nèi)容并予以顯示
}
else {
// disable the Code Window controls
}

CComPtr<IHTMLElement> m_pBody;
hr = spHTML->get_body(&m_pBody);

BSTR bstrHTMLText;
hr = m_pBody->get_outerHTML(&bstrHTMLText);

HRESULT CViewSource::GetDocumentContent()
{
USES_CONVERSION;
// 獲取 WebBrowser的文檔對象
CComPtr<IDispatch> pDisp;
HRESULT hr = m_spWebBrowser2->get_Document(&pDisp);
if (FAILED(hr))
return hr;
// 確保我們?nèi)〉玫氖且粋€IHTMLDocument2接口指針
//讓我們查詢一下 IHTMLDocument2 接口 (使用靈敏指針)
CComQIPtr<IHTMLDocument2， &IID_IHTMLDocument2> spHTML;
spHTML = pDisp;
// 抽取文檔源代碼
if (spHTML)
{
// 取得BODY 對象
hr = spHTML->get_body(&m_pBody);
if (FAILED(hr))
return hr;
// 取得HTML 文本
BSTR bstrHTMLText;
hr = m_pBody->get_outerHTML(&bstrHTMLText);
if (FAILED(hr))
return hr;
// 進行文本的Unicode到 ANSI的轉(zhuǎn)換
LPTSTR psz = new TCHAR[SysStringLen(bstrHTMLText)];
lstrcpy(psz， OLE2T(bstrHTMLText));
// 文本進行相應的調(diào)整
HWND hwnd = m_dlgCode.GetDlgItem(IDC_TEXT);
EnableWindow(hwnd， true);
hwnd = m_dlgCode.GetDlgItem(IDC_APPLY);
EnableWindow(hwnd， true);
// 設(shè)置代碼窗口中的文本
m_dlgCode.SetDlgItemText(IDC_TEXT， psz);
delete [] psz;
}
else   // 文檔不是一個 HTML 頁
{
m_dlgCode.SetDlgItemText(IDC_TEXT， "");
HWND hwnd = m_dlgCode.GetDlgItem(IDC_TEXT);
EnableWindow(hwnd， false);
hwnd = m_dlgCode.GetDlgItem(IDC_APPLY);
EnableWindow(hwnd， false);
}
return S_OK;
}

DWORD dwType， dwVal;
DWORD dwSize = sizeof(DWORD);
SHGetValue(HKEY_CURRENT_USER， _T("Software\\MSDN\\BHO")， _T("ShowWindowAtStartup")， &dwType， &dwVal， &dwSize);

HKLM {
SOFTWARE {
Microsoft {
Windows {
CurrentVersion {
Explorer {
''BHO'' {
ForceRemove {1E1B2879-88FF-11D2-8D96-D7ACAC95951F}
}}}}}}}