IURLSearchHook interface (shlobj_core.h)

Exposes a method that is used by the browser to translate the address of an unknown URL protocol.

Inheritance

The IURLSearchHook interface inherits from the IUnknown interface. IURLSearchHook also has these types of members:

Methods

The IURLSearchHook interface has these methods.

 
IURLSearchHook::Translate

Called by the browser when the browser cannot determine the protocol of a URL address.

Remarks

When attempting to browse to a URL address that does not contain a protocol, the browser will first attempt to determine the correct protocol from the address. If this is not successful, the browser will create URL Search Hook objects and call each object's Translate method until the address is translated or all of the hooks have been queried.

URL Search Hooks are registered by adding a value that contains the object's class identifier (CLSID) string under the following key in the registry:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Internet Explorer
            UrlSearchHooks

Implement this interface if your application defines a custom URL protocol and if address translation for this protocol is required.

You do not typically use this interface; it is called by the browser.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlobj_core.h