ClipboardObject.IDataObject.GetDataHere(FORMATETC[], STGMEDIUM[]) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Data.Framework

Assembly:: Microsoft.VisualStudio.Data.Framework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Obtains data from a source data object. This method, which is called by a data consumer, differs from the IDataObject.GetData(FORMATETC[], STGMEDIUM[]) method in that the caller must allocate and free the specified storage medium.

 virtual void Microsoft.VisualStudio.OLE.Interop.IDataObject.GetDataHere(cli::array <Microsoft::VisualStudio::OLE::Interop::FORMATETC> ^ pFormatetc, cli::array <Microsoft::VisualStudio::OLE::Interop::STGMEDIUM> ^ pRemoteMedium) = Microsoft::VisualStudio::OLE::Interop::IDataObject::GetDataHere;

void IDataObject.GetDataHere (Microsoft.VisualStudio.OLE.Interop.FORMATETC[] pFormatetc, Microsoft.VisualStudio.OLE.Interop.STGMEDIUM[] pRemoteMedium);

abstract member Microsoft.VisualStudio.OLE.Interop.IDataObject.GetDataHere : Microsoft.VisualStudio.OLE.Interop.FORMATETC[] * Microsoft.VisualStudio.OLE.Interop.STGMEDIUM[] -> unit
override this.Microsoft.VisualStudio.OLE.Interop.IDataObject.GetDataHere : Microsoft.VisualStudio.OLE.Interop.FORMATETC[] * Microsoft.VisualStudio.OLE.Interop.STGMEDIUM[] -> unit

Sub GetDataHere (pFormatetc As FORMATETC(), pRemoteMedium As STGMEDIUM()) Implements IDataObject.GetDataHere

Parameters

pFormatetc: FORMATETC[]

A reference to a FORMATETC structure, passed by reference, that defines the format, medium, and target device to use when passing the data. Only one medium can be specified in tymed, and only the following TYMED values are valid: TYMED_ISTORAGE, TYMED_ISTREAM, TYMED_HGLOBAL, and TYMED_FILE.

pRemoteMedium: STGMEDIUM[]

A STGMEDIUM, passed by reference, that defines the storage medium containing the data being transferred. The medium must be allocated by the caller and filled in by this method. The caller must also free the medium. The implementation of this method must always supply a value of null for the pUnkForRelease member of the STGMEDIUM structure that this parameter points to.

Implements

GetDataHere(FORMATETC[], STGMEDIUM[])

Exceptions

ArgumentNullException

The clipboard object is not a wrapped Microsoft.VisualStudio.OLE.Interop.IDataObject and the pFormatetc and/or pRemoteMedium parameters are null.

ArgumentException

The clipboard object is not a wrapped Microsoft.VisualStudio.OLE.Interop.IDataObject and the length of the pFormatetc and/or pRemoteMedium structures are zero.

Applies to