Extends IDocHostUIHandler with a method that facilitates Windows Internet Explorer registry changes.
GetOverrideKeyPath Gets a registry subkey path that modifies Internet Explorer user preferences.
On initialization, MSHTML calls QueryInterface on the host's client site, and requests an IDocHostUIHandler2 interface. If the interface is available, MSHTML calls IDocHostUIHandler2 methods during the lifetime of the MSHTML component.
By implementing this interface, MSHTML can communicate with the host about its user interface status. The host can use this interface to modify internal user interface elements, such as menus, context menus, and toolbars.
IDocHostUIHandler2::GetOverrideKeyPath provides an alternate mechanism to IDocHostUIHandler::GetOptionKeyPath for a WebBrowser Control host to make changes in the registry settings for the WebBrowser Control. By using IDocHostUIHandler2::GetOverrideKeyPath, your WebBrowser Control instance preserves the registry settings for the current user. Any registry changes located at the registry path that are specified by this method override those located in HKEY_CURRENT_USER/Software/Microsoft/Internet Explorer. Compare this to IDocHostUIHandler::GetOptionKeyPath, which causes a WebBrowser Control instance to default to its original settings before registry changes are applied from the registry path specified by the method.Note The version 5.5 WebBrowser Control does not query its host for IDocHostUIHandler2 (Knowledge Base Q272968). If you are hosting Mshtml.dll directly, MSHTML version 5.5 will query for IDocHostUIHandler2. The version 6 WebBrowser Control does query for IDocHostUIHandler2.
Stock Implementation shdocvw.dll Custom Implementation Yes Inherits from IDocHostUIHandler Header and IDL files mshtmhst.h, mshtmhst.idl Minimum availability Internet Explorer 5.5 Minimum operating systems Windows 95, Windows NT 4.0, Windows CE 4.0