IWebApplicationNavigationEvents::BeforeNavigate method (webapplication.h)

Fired before navigate occurs in the given host (window or frameset element).

Syntax

HRESULT BeforeNavigate(
  [in] IHTMLWindow2 *htmlWindow,
  [in] LPCWSTR      url,
  [in] DWORD        navigationFlags,
  [in] LPCWSTR      targetFrameName
);

Parameters

[in] htmlWindow

Type: IHTMLWindow2*

The window or frame in which the navigation is about occur.

[in] url

Type: LPCWSTR

The URL to navigate to.

[in] navigationFlags

Type: DWORD

Flags related to the current navigation.

[in] targetFrameName

Type: LPCWSTR

The name of the frame in which the navigation is about to occur. The value is null if no named frame is targeted.

Return value

Type: HRESULT

Ignored by the host. If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header webapplication.h

See also

IWebApplicationNavigationEvents