FireBeforeNavigate2 method

Deprecated. Causes the browser to fire the DISPID_BEFORENAVIGATE event.

Syntax

HRESULT retVal = object.FireBeforeNavigate2(pDispatch, lpszUrl, dwFlags, lpszFrameName, pPostData, cbPostData, lpszHeaders, fPlayNavSound, pfCancel);

Parameters

  • pDispatch [in]
    Type: IDispatch

    A pointer to the IDispatch interface for the WebBrowser for the event.

  • lpszUrl [in]
    Type: LPCTSTR

    The URL for which the event is fired.

  • dwFlags [in]
    Type: DWORD

    Applicable flags.

  • lpszFrameName [in]
    Type: LPCTSTR

    The frame name for the event.

  • pPostData [in]
    Type: BYTE

    A pointer to post data for the event.

  • cbPostData [in]
    Type: DWORD

    The post data size, in bytes.

  • lpszHeaders [in]
    Type: LPCTSTR

    HTTP headers to send with the event.

  • fPlayNavSound [in]
    Type: BOOL

    Specifies whether to play a sound.

  • pfCancel [out]
    Type: BOOL

    Receives whether the operation should be canceled.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

IDocObjectService::FireBeforeNavigate2 was introduced in Microsoft Internet Explorer 6.