HlinkQueryCreateFromData

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

HRESULT HlinkQueryCreateFromData(
  IDataObject* piDataObj  //Data object to query
);
 

Parameters

piDataObj

[in] Pointer to the IDataObject interface supplying the hyperlink formats.

Return Values

S_OK

A hyperlink can be created from the data object.

S_FALSE

A hyperlink cannot be created from the data object.

Remarks

The application must call the HlinkQueryCreateFromData function to find out whether the hyperlink can be created from the data object 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.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in hlink.h.

See Also

HlinkCreateFromData