Share via


IBrowser::FrameNavigate

The FrameNavigate method navigates the frame to the specified location and displays the contents in the folder view.

Syntax

HRESULT FrameNavigate(
  BSTR bstrURL,
  BSTR bstrTarget,
  BSTR bstrSource,
  BSTR bstrPostData,
  BOOL * pbCancel
);

Parameters

  • bstrURL
    [in] String expression that evaluates to the URL, full path, or Universal Naming Convention (UNC) location and name of the resource to display.

  • bstrTarget
    [in] String that specifies the frame in which to display the resource. The possible values for this parameter are described in the following table.

    Value Description
    _blank Load the link into a new unnamed window.
    _parent Load the link into the immediate parent of the document the link is in.
    _self Load the link into the same window the link was clicked in.
    _top Load the link into the full body of the current window.
    window name A named HTML frame.
  • bstrSource
    [in] String that contains the name of the resource.

  • bstrPostData
    [in] Data to send with the HTTP POST transaction. For example, the POST transaction is used to send data gathered by an HTML form.

  • pbCancel
    [in] Reference to a Boolean value; TRUE if the navigation succeeds and FALSE if the navigation fails.

Return Values

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

  • S_OK
    The method completed successfully.

Requirements

Pocket PC: Windows Mobile 2002 and later
OS Versions: Windows CE 4.0 and later
Header: webvw.h
Library: webvw.lib

See Also

_DPIEWebBrowserEvents2::BeforeNavigate2

_DPIEWebBrowserEvents2::NavigateComplete2

IBrowser

IBrowser::navigate

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.