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.

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
);