Edit

Share via

OleQueryLinkFromData function (ole2.h)

  • Article

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

Requirement Value
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
API set ext-ms-win-com-ole32-l1-1-3 (introduced in Windows 10, version 10.0.10240)