OleQueryLinkFromData function

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

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

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header ole2.h
Library Ole32.lib
DLL Ole32.dll