OleQueryLinkFromData function (ole2.h)

Determines whether an OLE linked object (rather than an OLE embedded object) can be created from a clipboard data object.

Syntax

HRESULT OleQueryLinkFromData(
  [in] LPDATAOBJECT pSrcDataObject
);

Parameters

[in] pSrcDataObject

Pointer to the IDataObject interface on the clipboard data object from which the object is to be created.

Return value

Returns S_OK if the OleCreateLinkFromData function can be used to create the linked object; otherwise S_FALSE.

Remarks

The OleQueryLinkFromData function is similar to the OleQueryCreateFromData function, but determines whether an OLE linked object (rather than an OLE embedded object) can be created from the clipboard data object. If the return value is S_OK, the application can then attempt to create the object with a call to OleCreateLinkFromData. A successful return from OleQueryLinkFromData does not, however, guarantee the successful creation of a link.

Requirements