HlinkQueryCreateFromData function

[HlinkQueryCreateFromData may be altered or unavailable in subsequent versions of the operating system or product.]

Note  The Microsoft ActiveX Hyperlink API is deprecated in Windows Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.

Determines if a new hyperlink can be created from an IDataObject interface.

Syntax

HRESULT HlinkQueryCreateFromData(
  _In_ IDataObject* piDataObj
);

Parameters

• piDataObj [in]
  The address of the IDataObject interface supplying the hyperlink formats.

Return value

Returns S_OK if a hyperlink can be created from the data object, or S_FALSE if not.

Remarks

The application must call the HlinkQueryCreateFromData function to find out whether the hyperlink can be created from the data object that is obtained from the clipboard, from a drag-and-drop operation, or from any other means.

A hyperlink can be created if the IDataObject interface supports one of the following formats: cfHyperlink, cfUniformResourceLocator, CF_HDROP, or cfFileName.

Requirements

See also

HlinkCreateFromData