DataObject.IDataObject.GetDataHere(FORMATETC, STGMEDIUM) Method

Definition

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

 virtual void System.Runtime.InteropServices.ComTypes.IDataObject.GetDataHere(System::Runtime::InteropServices::ComTypes::FORMATETC % formatetc, System::Runtime::InteropServices::ComTypes::STGMEDIUM % medium) = System::Runtime::InteropServices::ComTypes::IDataObject::GetDataHere;
void IDataObject.GetDataHere (ref System.Runtime.InteropServices.ComTypes.FORMATETC formatetc, ref System.Runtime.InteropServices.ComTypes.STGMEDIUM medium);
Sub GetDataHere (ByRef formatetc As FORMATETC, ByRef medium As STGMEDIUM) Implements IDataObject.GetDataHere

Parameters

formatetc
FORMATETC

A pointer 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, or TYMED_FILE.

medium
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 GetDataHere(FORMATETC, STGMEDIUM). 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

Remarks

This member is an explicit interface member implementation. It can be used only when the DataObject is cast to an IDataObject interface.

Applies to