Share via


AutoScan method

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

This method is not supported for Windows apps using JavaScript.

Syntax

HRESULT retVal = object.AutoScan(strSearch, strFailureUrl, pvarTargetFrame);

Parameters

  • strSearch [in]
    Type: BSTR

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

  • strFailureUrl [in]
    Type: BSTR

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

    A BSTR that specifies the IHTMLAnchorElement::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:

  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).