Creates a new hyperlink object from strings representing the hyperlink target, the location within the target, and a friendly name.
HRESULT HlinkCreateFromString(
LPCWSTR pwzTarget, //String helping to identify the hyperlink
// target
LPCWSTR pwzLocation, //Location within the hyperlink target of
// new hyperlink object
LPCWSTR pwzFriendlyName, //Friendly name of the hyperlink
IHlinkSite * pihlsite, //Site for the new hyperlink object
DWORD dwSiteData, //Additional site data for the new
// hyperlink object
IUnknown * piunkOuter, //Whether or not object is part of an
// aggregate
REFIID riid, //Interface identifier on new browse
// context object
Void * ppvObj //Address of output variable that receives
// the interface pointer requested in riid
);
HlinkCreateFromString is one of three helper functions that you can use to create a hyperlink. HlinkCreateFromData creates a hyperlink from a COM object which supports both the IDataObject interface and a hyperlink format CF_HYPERLINK on that IDataObject interface. HlinkQueryCreateFromData is typically called before the call to HlinkCreateFromData to determine if both these conditions are met.
To create a hyperlink from a COM object for which you know the moniker, use HlinkCreateFromMoniker. To create a hyperlink from a COM object for which you have the name but not the moniker, use HlinkCreateFromString.
HlinkCreateFromString is typically used by hyperlink containers as part of the user interface for creating brand new hyperlinks, where the user fills in a form or dialog box of items -- target, location, friendly name -- which are used to construct the hyperlink.
Windows NT: Use version 5.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in hlink.h.
HlinkCreateFromData, HlinkCreateFromMoniker, HlinkQueryCreateFromData