IShellUIHelper::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.

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

Community Additions

Show: