IHlink Interface

---

This interface provides methods that enable a hyperlink to navigate to its target, access a display name for display purposes, and identify itself to its container and frame.

IHlink Methods

GetAdditionalParams	Not currently implemented.
GetFriendlyName	Retrieves the display name of the target.
GetHlinkSite	Retrieves the interface pointer on the site object.
GetMiscStatus	Retrieves a value that indicates whether the hyperlink is absolute or relative.
GetMonikerReference	Retrieves the moniker and location portions of the target.
GetStringReference	Retrieves the name and location portions of the target.
GetTargetFrameName	Retrieves the name of the target frame.
Navigate	Navigates to the given target.
SetAdditionalParams	Not currently implemented.
SetFriendlyName	Sets the display name of the target.
SetHlinkSite	Saves the interface pointer on the site object.
SetMonikerReference	Sets the moniker reference of the target.
SetStringReference	Sets the name and location portions of the target.
SetTargetFrameName	Sets the name of the target frame.

Interface Information

Implementation	Hyperlink Object (Hlink.dll)
Inherits from	IUnknown
Header and IDL files	Hlink.h; Hlink.idl
Minimum availability	Internet Explorer 4.0
Minimum operating systems	Windows 95, Windows NT 4.0

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

Remarks

The IHlink interface enables a COM object known as a hyperlink to completely encapsulate the behavior of navigating to its target location. Hyperlinks are managed by COM hyperlink container objects, which support the IHlinkSite interface for hyperlinks within the container, and the IHlinkTarget interface for hyperlinks referring to documents or document objects within it.

A document can use the standard Hyperlink Object to represent hyperlinks within itself, thus encapsulating the capability of navigating, saving, loading, dragging, dropping, cutting, and pasting hyperlinks. The standard Hyperlink Object implements IHlink, IPersistStream, and IDataObject interfaces.

The support for IPersistStream means that the Hyperlink Object can be saved to or loaded from a stream, and the support for IDataObject means that the object can be cut and pasted.

IHlink interfaces are typically called by an application's hyperlink container as part of a user interface for creating new hyperlinks. A standard Hyperlink Object can be created through the HlinkCreateFromData, HlinkCreateFromMoniker, HlinkCreateFromString, and OleLoadFromStream functions.