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

var retval = external.AutoScan(strSearch, strFailureUrl, pvarTargetFrame);

Parameters

  • strSearch [in]
    Type: BSTR

    A String that specifies a domain address that begins with www., and ends with .com, .org, .net, or .edu.

  • strFailureUrl [in]
    Type: BSTR

    A String 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, optional]
    Type: VARIANT

    A String that specifies the target window or frame where the results are displayed. The default value is the current window.

Return value

Type: HRESULT

This method can return one of these values.

Return code Description
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).

Examples

This example uses the AutoScan method to connect to the www.microsoft.com Web site.

window.external.AutoScan("microsoft","InvalidSite.htm","_main");