HlinkNavigate Function

---

Navigates to a hyperlink, given a hyperlink object and an optional hyperlink frame object.

Syntax

HRESULT HlinkNavigate(
    IHlink *pihl,    
    IHlinkFrame *pihlframe,    
    DWORD grfHLNF,    
    LPBC pbc,    
    IBindStatusCallback *pibsc,    
    IHlinkBrowseContext *pihlbc    
);

Parameters

pihl

[in] Address of the IHlink interface on the target hyperlink.

pihlframe

[in] Address of the IHlinkFrame interface of the hyperlink container. This can be NULL if the hyperlink container does not have a hyperlink frame.

grfHLNF

[in] Value taken from the HLNF enumeration.

pbc

[in] Address of the IBindCtx interface on the bind context to use for any moniker binding performed during the navigation. This must not be NULL.

pibsc

[in] Address of the IBindStatusCallback interface on the bind status context to use for any asynchronous moniker binding performed during the navigation. This can be NULL, in which case the caller is not interested in progress notification, cancellation, pausing, or low-level binding information.

pihlbc

[in] Address of the IHlinkBrowseContext interface pointer to use for this navigation. The browse context includes history information, where this navigation is logged if grfHLNF is not set to HLNF_CREATENOHISTORY.

Return Value

Returns S_OK if successful, or an error code otherwise.

Example

HlinkNavigate encapsulates the following common sequence of calls:

if (phlFrame)
    phlFrame->Navigate(grfHLNF, pbc, pbsc, phl);
else if (phl)
    phl->Navigate(grfHLNF, pbc, pbsc, phlbc);

Function Information

Windows NT	Use version 4.0.
Windows	Use Windows 95 and later.
Header	Hlink.h
Import Library	Hlink.lib
Minimum availability	Internet Explorer 3.0

See Also

IHlink::Navigate, IHlinkFrame::Navigate, IHlinkTarget::Navigate