HlinkNavigate

This helper function can be used to navigate to a hyperlink, given a hyperlink object and an optional hyperlink frame object.

HRESULT HlinkNavigate(

IHlink * pihl,

//The target hyperlink

IHlinkFrame * pihlframe,

//The hyperlink frame of the hyperlink container

DWORD grfHLNF,

//Navigation flags

LPBC pbc,

//Bind context object interface pointer

IBindStatusCallback * pibsc,

//Bind status callback object interface pointer

IHlinkBrowseContext * pihlbc

//Browse context object interface pointer

);

Parameters

pihl: [in] Pointer to the IHlink interface on the target hyperlink.
pihlframe: [in] Pointer to the IHlinkFrame interface of the hyperlink container. May be NULL if the hyperlink container does not have a hyperlink frame.
grfHLNF: [in] Value taken from the HLNF enumeration.
pbc: [in] Pointer to the IBindCtx interface on the bind context to use for any moniker binding performed during the navigation. Must not be NULL.
pibsc: [in] Pointer to the IBindStatusCallback interface on the bind status context to use for any asynchronous moniker binding performed during the navigation. May be NULL, in which case the caller is not interested in progress notification, cancellation, pausing, or low-level binding information.
pihlbc: [in] Pointer to the IHlinkBrowseContext interface pointer to use for this navigation. The browse context includes history information in which this navigation is logged, if !(grfHLNF & HLNF_CREATENOHISTORY).

Remarks

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);

IHlink * pihl,	//The target hyperlink
IHlinkFrame * pihlframe,	//The hyperlink frame of the hyperlink container
DWORD grfHLNF,	//Navigation flags
LPBC pbc,	//Bind context object interface pointer
IBindStatusCallback * pibsc,	//Bind status callback object interface pointer
IHlinkBrowseContext * pihlbc	//Browse context object interface pointer
);