IDataObject.GetData Method

Note: This method is new in the .NET Framework version 2.0.

Obtains data from a source data object. The GetData method, which is called by a data consumer, renders the data described in the specified FORMATETC structure and transfers it through the specified STGMEDIUM structure. The caller then assumes responsibility for releasing the STGMEDIUM structure.

Namespace: System.Runtime.InteropServices.ComTypes
Assembly: System (in system.dll)

void GetData (
	[InAttribute] ref FORMATETC format,
	out STGMEDIUM medium
void GetData (
	/** @attribute InAttribute() */ /** @ref */ FORMATETC format, 
	/** @attribute OutAttribute() */ /** @ref */ STGMEDIUM medium
JScript does not support passing value-type arguments by reference.



A pointer to a FORMATETC structure, passed by reference, that defines the format, medium, and target device to use when passing the data. It is possible to specify more than one medium by using the Boolean OR operator, allowing the method to choose the best medium among those specified.


When this method returns, contains a pointer to the STGMEDIUM structure that indicates the storage medium containing the returned data through its tymed member, and the responsibility for releasing the medium through the value of its pUnkForRelease member. If pUnkForRelease is a null reference (Nothing in Visual Basic), the receiver of the medium is responsible for releasing it; otherwise, pUnkForRelease points to the IUnknown interface on the appropriate object so its Release method can be called. The medium must be allocated and filled in by GetData. This parameter is passed uninitialized.

For more information about IDataObject::GetData, see the MSDN Library.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0