IHlink::Navigate

IHlink::Navigate

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

HRESULT Navigate(

    DWORD

grfHLNF,                      // Navigation flags

    IBindCtx * pbc,                     // Bind context interface pointer

    IBindStatusCallback * pbsc,         // Bind-status-context interface pointer

    IHlinkBrowseContext * phlbc         // Browse context interface pointer

);

Parameters

grfHLNF

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

pbc

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

pbsc

[in] 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

phlbc

[in] Pointer to the IHlinkBrowseContext interface to use for this navigation. May not be NULL. As part of navigation, this browse contextÆs navigation stack may 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.

Return Values

S_OK

Navigation to the hyperlink has been completed successfully.

HLINK_S_NAVIGATEDTOLEAFNODE