CBaseBrowser

The CBaseBrowser class is one of many that SHDOCVW exposes through its exported DllGetClassObject function. Instances can therefore be created using such well-documented COM functions as CoCreateInstance, by anyone who knows the CLSID:

The CBaseBrowser class can be aggregated.

Interfaces

The CBaseBrowser class implements the following interfaces:

• IAdviseSink
• IBrowserService4 (7.0) and its bases IBrowserService3 (6.0 before Windows Vista, and 7.0), IBrowserService2 (5.0 to 6.0 before Windows Vista, and 7.0) and IBrowserService (5.0 to 6.0 before Windows Vista, and 7.0)
• IBrowserWithTabWindows (7.0)
• IDocNavigate
• IDocObjectService (5.50, 6.0 and 7.0)
• IDropTarget
• IInitViewLinkedWebOC (6.0 and 7.0)
• IInputObjectSite
• IInternetSecurityMgrSite
• ILayoutModifier (6.0 from Windows Vista)
• INotifyAppStart (6.0 and 7.0)
• IOleCommandTarget
• IOleContainer
• IOleInPlaceUIWindow
• IPersistHistory2 (6.0 from Windows Vista, and 7.0) and its base IPersistHistory (5.0 to 6.0, and 7.0)
• IProfferService (5.50, 6.0 and 7.0)
• IProtectFocus (7.0)
• IServiceProvider
• IShellBrowser and its base IOleWindow
• IShellBrowserService4 and its bases IShellBrowserService3, IShellBrowserService2 and IShellBrowserService (6.0 from Windows Vista)
• IShellBrowserWithTabWindows (6.0 from Windows Vista)
• ITrackEvents (6.0 from Windows Vista, and 7.0)
• ITravelLogClient (5.50, 6.0 and 7.0)
• ITravelLogClient2 (5.50 to 6.0 before Windows Vista)
• ITravelLogClientWrapper (6.0 from Windows Vista, and 7.0)
• ITridentService2 (6.0 and 7.0)
• ITridentService3 (6.0 from Internet Explorer 7 but not for Windows Vista, and then 7.0)
• IVersionHost
• IViewFrameHost (6.0 from Windows Vista)
• IWebBrowserEventsService (6.0 from Windows Vista, and 7.0)

In version 6.0 before Windows Vista, the ITridentService2 interface has IDocObjectService as a base. However, the two have separate virtual function tables later.

The ITridentService3 interface is implemented in the SHDOCVW builds of version 6.0 from Internet Explorer 7 (and 8) for installation on Windows XP or Windows Server 2003, including the later builds for Windows XP SP3 and Windows Server 2003 SP2.

The IOleWindow interface is a base of both IOleInPlaceUIWindow and IShellBrowser: the latter is the one that is picked for discovery through QueryInterface.

The IPersistHistory2 and IPersistHistory interfaces have IPersist as a base, but because its IID is omitted from the table used for QueryInterface, it is not discoverable through COM mechanisms as being implemented by the class. The omission is presumably a coding error, since it breaks COM rules about interface navigation.

Builds of version 6.0 before Windows Vista also implement the IShellBrowserService interface, but may as well not: presumably as a coding oversight, QueryInterface does not know of the implementation, which can therefore never be discovered through COM mechanisms. Curiously, IEFRAME version 7.0 does the same thing with the IIEBrowserService interface which is the IShellBrowserService with a new name and IID but the same methods. Note anyway that this implemented-but-not-disclosed IShellBrowserService interface differs from the one that is a base for IShellBrowserService4 in later builds of version 6.0, and differs yet again from an IShellBrowserService that is implemented in SHELL32 version 6.1.

Availability

The CBaseBrowser class is implemented in SHDOCVW version 5.0 to 6.0 and then in IEFRAME version 7.0 only. The change of CLSID allows separate implementations in the two modules concurrently.

IEFRAME version 8.0 has the class but it is not creatable.

Though this class dates from as long ago as 1999, it was still not documented by Microsoft as late as the January 2007 edition of the Windows Vista Software Development Kit (SDK).