HlinkNavigate Function

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

Syntax

Copy

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

Parameters

pihl

[in] The address of the IHlink interface on the target hyperlink.

pihlframe

[in] The 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] The value taken from the HLNF enumeration.

pbc

[in] The 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] The address of the IBindStatusCallback interface on the bind status context to use for any asynchronous moniker binding performed during the navigation. If this is NULL, the caller does not receive progress notification, cancellation, pausing, or low-level binding information.

pihlbc

[in] The 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 value otherwise.

Example

HlinkNavigate encapsulates the following common sequence of calls.

Copy

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

Function Information

Stock Implementation	Hlink.dll
Custom Implementation	No
Header	Hlink.h
Import library	Hlink.lib
Minimum availability	Internet Explorer 3.0
Minimum operating systems	Windows NT 4.0, Windows 95

See Also

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