Contents Index Topic Contents
	Previous Topic: IHlink::GetTargetFrameName Next Topic: IHlink::SetAdditionalParams

IHlink::Navigate

HRESULT Navigate(
    DWORD grfHLNF,    //Navigation flags
    LPBC pibc,        //Bind context interface pointer 
    IBindStatusCallback * pibsc,    //Bind-status-context interface pointer
    IHlinkBrowseContext * pihlbc    //Browse context interface pointer
   );

Navigates to the hyperlink reference. IHlink::Navigate is the heart of the navigation process that implements the action of resolving a hyperlink target.

• Returns S_OK if navigation to the hyperlink has been completed successfully.

grfHLNF

[in] Flags describing how the navigation is to proceed. The value of the flag can be any valid HLNF enumeration value.

pibc

[in, unique] IBindCtx interface pointer to the bind context to be used for any moniker binding during this operation. Cannot be NULL.

pibsc

[in, unique] IBindStatusCallback interface pointer to the bind status context to use for any asynchronous moniker binding performed during the navigation. If NULL, the caller is not interested in progress notification, cancellation, pausing, or low-level binding information

pihlbc

[in, unique] Address of the IHlinkBrowseContext interface to use for this navigation. Cannot be NULL. As part of navigation, this browse context's navigation stack can be updated (depending on the navigation flags in grfHLNF), and its cache of hyperlink targets is consulted for a matching to the current hyperlink target.

See also HlinkNavigate, HLNF, IHlinkFrame::Navigate, IHlinkTarget::Navigate

---

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