ClipboardObject.IDataObject.QueryGetData Method

Article
10/02/2013

Determines whether the data object is capable of rendering the data described in the FORMATETC structure. Objects attempting a paste or drop operation can call this method before calling IDataObject.GetData to get an indication of whether the operation will be successful.

Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (in Microsoft.VisualStudio.Data.Framework.dll)

Syntax

'Declaration
Private Function QueryGetData ( _
    pFormatetc As FORMATETC() _
) As Integer Implements IDataObject.QueryGetData

int IDataObject.QueryGetData(
    FORMATETC[] pFormatetc
)

private:
virtual int QueryGetData(
    array<FORMATETC>^ pFormatetc
) sealed = IDataObject::QueryGetData

private abstract QueryGetData : 
        pFormatetc:FORMATETC[] -> int  
private override QueryGetData : 
        pFormatetc:FORMATETC[] -> int

JScript does not support explicit interface implementations.

Parameters

pFormatetc
Type: array<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]

A reference to a FORMATETC structure, passed by reference, that defines the format, medium, and target device to use for the query.

Return Value

Type: System.Int32
This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following:

Value	Description
S_OK	A subsequent call to GetData will probably be successful.
DV_E_LINDEX	There is an invalid value for lindex; currently, only -1 is supported.
DV_E_FORMATETC	There is an invalid value for the pFormatetc parameter.
DV_E_TYMED	There is an invalid tymed value.
DV_E_DVASPECT	There is an invalid dwAspect value.
OLE_E_NOTRUNNING	The application is not running.

Implements

IDataObject.QueryGetData(array<FORMATETC[])

Remarks

If the clipboard object wraps an existing IDataObject (from the Microsoft.VisualStudio.OLE.Interop namespace), this method delegates the call to the corresponding QueryGetData from that namespace. Otherwise, it attempts to translate the call to the corresponding IDataObject.QueryGetData from the System.Runtime.InteropServices.ComTypes namespace, in case the clipboard object could be wrapping an existing IDataObject.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via