AutoScan method

Obsolete 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: String

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

strFailureUrl [in]

Type: String

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_OK	The operation completed successfully.
S_FALSE	An error occurred.
E_NOTIMPL	Internet Explorer 7 and later. Not implemented.

Standards information

There are no standards that apply here.

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:

.com
.org
.net
.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.

JavaScript


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