_DPIEWebBrowserEvents2::BeforeNavigate2 (Windows CE 5.0)

Article
09/14/2012

The BeforeNavigate2 event method fires before navigation occurs in the given object on either a window or frameset element.

Syntax

void BeforeNavigate2(  IDispatch* pdisp,  VARIANT* pvtURL,  VARIANT* pvtFlags,  VARIANT* pvtTargetFrameName,  VARIANT* pvtPostData,  VARIANT* pvtHeaders,  VARIANT_BOOL* pvbCancel);

Parameters

pdisp
[in] Reference to the IDispatch interface for the object that represents the window or frame.
pvtURL
[in] Reference to a Windows CE VARIANT structure of type VT_BSTR that contains the URL.
pvtFlags
[in] Reserved; must be set to NULL.
pvtTargetFrameName
[in] Reference to a VARIANT structure of type VT_BSTR that contains the name of the frame in which to display the resource or is set to NULL if a named frame is not targeted.
pvtPostData
[in] Reference to a VARIANT structure of type VT_BYREF|VT_VARIANT that contains the data to send to the server if the HTTP POST transaction is being used.
pvtHeaders
[in] Reference to a VARIANT structure of type VT_BSTR that contains additional HTTP headers to send to the server (HTTP URLs only). The headers can specify information such as the required server action, the type of data being passed to the server, and a status code.
pvbCancel
[out] Reference to a VARIANT structure of type VARIANT_BOOL with a VARIANT_TRUE value to cancel navigation and a VARIANT_FALSE value to allow navigation.

Return Values

None.

Remarks

The post data specified by pvtPostData is passed as a Windows CE SAFEARRAY structure. The Variant should be of type VT_BYREF|VT_VARIANT, which points to a SAFEARRAY. The SAFEARRAY should be of element type VT_UI1, contain one dimension, and have an element count equal to the number of bytes of post data.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: webvw.h
Library: wvuuid.lib