Creates a standard hyperlink object from a COM object that supports the IDataObject interface. Typically, this object originates from a data transfer operation, such as copying to and pasting from the clipboard, or via a drag-and-drop operation.
HRESULT HlinkCreateFromData(
IDataObject* piDataObj, //Interface on target data from which to
// create the hyperlink
IHlinkSite* pihlsite, //Interface on hyperlink site
DWORD dwSiteData, //Additional site data
IUnknown *piunkOuter, //Interface which controls aggregation
REFIID riid, //Interface identifier on new hyperlink
// object
Void ** ppvObj //Address of output variable that receives
// the interface pointer requested in riid
);
HlinkCreateFromData 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.
HlinkCreateFromData is typically used by a hyperlink container as part of a user interface that creates new hyperlinks via the clipboard or a drag-and-drop operation.
Windows NT: Use version 5.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in hlink.h.
HlinkCreateFromMoniker, HlinkCreateFromString, HlinkQueryCreateFromData