OnNavigateHlink method

[IHlinkBrowseContext::OnNavigateHlink may be altered or unavailable in subsequent versions of the operating system or product.]

Note  The Microsoft ActiveX Hyperlink API is deprecated in Windows Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.

 

Notifies a browse context that a hyperlink has been clicked.

Syntax

HRESULT retVal = object.OnNavigateHlink(grfHLNF, pimkTarget, pwzLocation, pwzFriendlyName, puHLID);

Parameters

  • grfHLNF [in]
    Type: DWORD

    An unsigned integer value that specifies a flag that describes how the navigation is to proceed. This can be any of the HLNF values.

  • pimkTarget [in]
    Type: IMoniker

    The address of an IMoniker interface on the hyperlink target.

  • pwzLocation [in]
    Type: LPCWSTR

    The address of a string that indicates the location in the hyperlink target to which the browser navigated. This cannot be NULL.

  • pwzFriendlyName [in]
    Type: LPCWSTR

    The address of a string that contains the display name of the location in the hyperlink target to which the browser navigated. This cannot be NULL.

  • puHLID [out]
    Type: unsigned long

    The address of the hyperlink identifier to set in the current browse context's navigation stack.

See also

Reference

HlinkOnNavigate

IHlinkFrame::OnNavigate

IHlinkSite::OnNavigationComplete