IShellUIHelper::NavigateAndFind Method

  • Article

Navigates to the specified URL and selects the specified text.

Navigates to the specified URL and selects the specified text.

Syntax

HRESULT NavigateAndFind(
    BSTR URL,
    BSTR strQuery,
    VARIANT *varTargetFrame
);

Parameters

  • URL
    [in] A BSTR that specifies the URL of a Web page.
  • strQuery
    [in] A BSTR that specifies the text to highlight on the Web page specified by URL.
  • varTargetFrame
    [in] A pointer to a VARIANT of type VT_BSTR that specifies the name of the target frame to query.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This method requires a full qualified path, including a location prefix, for example, https://, c:\, and so on.

The target frame argument might be empty.

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

This method requires a user-initiated action to open a pop-up window, such as clicking on a link, or tabbing to a link and pressing enter. The Pop-up Blocker feature in Microsoft Internet Explorer 6 blocks windows that open without being initiated by the user.

See Also

window, About the Pop-up Blocker