HlinkNavigateHlinkNavigate*
*Contents  *Index  *Topic Contents
*Previous Topic: HlinkGoForward
*Next Topic: HlinkNavigateMoniker

HlinkNavigate

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

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

pihl
[in] Address of the IHlink interface on the target hyperlink.
pihlframe
[in] Address of the IHlinkFrame interface of the hyperlink container. 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. 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. 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 in which this navigation is logged, if !(grfHLNF & HLNF_CREATENOHISTORY).

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

See also IHlinkBrowseContext, IHlink::Navigate, IHlinkFrame::Navigate, IHlinkTarget::Navigate


Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.