IHlinkBrowseContext::OnNavigateHlink

Notifies a browse context that a hyperlink has been navigated.

HRESULT OnNavigateHlink(
  DWORD grfHLNF,          //Navigation flags
  IMoniker * pimkTarget,  //Moniker interface pointer of the 
                          //hyperlink target
  LPCWSTR pwzLocation,    //Location within the hyperlink target of 
                          //new hyperlink
  LPCWSTR pwzFriendlyName,  //Friendly name of the hyperlink
  ULONG * puHLID          //Pointer to hyperlink identifier
);
 

Parameters

grfHLNF

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

pimkTarget

[in, unique] Pointer to an IMoniker interface on the hyperlink target.

pwzLocation

[in, unique] A string identifying the location within the hyperlink target that was navigated to. Must not be NULL.

pwzFriendlyName

[in, unique] The friendly name of the location within the hyperlink target that has been navigated to. Must not be NULL.

puHLID

[out] Pointer to the hyperlink indentifier to set in the current browse context's navigation stack.

Return Values

S_OK

The browse context has been successfully notified that a hyperlink has been navigated.

QuickInfo

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

See Also

HlinkOnNavigate, HLNF, IHlinkFrame::OnNavigate, IHlinkSite::OnNavigationComplete