IShellUIHelper::AutoScan Method

  • Article

No longer available as of Windows Internet Explorer 7. Attempts to connect to a Web server by passing the specified query through completion templates.

Syntax

HRESULT AutoScan(
    BSTR strSearch,
    BSTR strFailureUrl,
    VARIANT *pvarTargetFrame
);

Parameters

  • strSearch
    [in] A BSTR that specifies a domain address that begins with www., and ends with .com, .org, .net, or .edu.
  • strFailureUrl
    [in] A BSTR that specifies the Web page to display if the domain address created from strSearch is invalid. The default Internet Explorer error page is displayed if a value is not provided.
  • pvarTargetFrame
    [in] A BSTR that specifies the target window or frame where the results are displayed. The default value is the current window.

Return Value

Returns one of the following values.

S_OK The operation completed successfully.
S_FALSE An error occurred.
E_NOTIMPL Internet Explorer 7 and later. Not implemented.

Remarks

The domain suffixes added to the user query are located in the system registry under HKEY_LOCAL_MACHINE\software\microsoft\internet explorer\main\urltemplate. Each suffix is appended in the following order until an existing server is found:

  1. .com
  2. .org
  3. .net
  4. .edu

If no server is found, the document specified by the strFailureUrl parameter is displayed.

This method is not supported in Introduction to HTML Applications (HTAs).