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
  LPBC pibc,                    //Bind context interface pointer
  IBindStatusCallback * pibsc,  //Bind-status-context interface 
                                //pointer
  IHlinkBrowseContext * pihlbc  //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, unique] IBindCtx interface pointer to the bind context to be used for any moniker binding during this operation. May not 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] 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.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in hlink.h.

See Also

HlinkNavigate, HLNF, IHlinkFrame::Navigate, IHlinkTarget::Navigate