IHlinkFrame::UpdateHlink

Updates the hyperlink frame. This method is called before navigation, typically by the IHlinkSite::ReadyToNavigate method. An application that does not implement the IHlinkSite interface can call this method before calling the navigation function.

HRESULT UpdateHlink(
  ULONG uHLID,            //Hyperlink to retrieve
  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
);
 

Parameters

uHLID

[in] Identifies the hyperlink to retrieve. May be a value taken from the HLID constants to indicate a logically identified hyperlink, such as HLID_PREVIOUS or HLID_NEXT.

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.

Return Values

S_OK

The hyperlink frame has been successfully updated.

QuickInfo

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

See Also

HlinkOnNavigate, HLID, IHlinkBrowseContext::OnNavigateHlink, IHlinkSite::OnNavigationComplete