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.

public:
 void GetDataHere(System::Runtime::InteropServices::ComTypes::FORMATETC % format, System::Runtime::InteropServices::ComTypes::STGMEDIUM % medium);
public void GetDataHere (ref System.Runtime.InteropServices.ComTypes.FORMATETC format, ref System.Runtime.InteropServices.ComTypes.STGMEDIUM medium);
abstract member GetDataHere : FORMATETC * STGMEDIUM -> unit
Public Sub GetDataHere (ByRef format As FORMATETC, ByRef medium As STGMEDIUM)

Parameters

format
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.

Remarks

For more information, see IDataObject::GetDataHere method.

Applies to