DataObject.IDataObject.GetData(FORMATETC, STGMEDIUM) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene los datos de un objeto de datos de origen. El método GetData(FORMATETC, STGMEDIUM), que es invocado por un consumidor de datos, representa los datos descritos en la estructura FORMATETC especificada y los transfiere a través de la estructura STGMEDIUM especificada. A continuación, el llamador asume la responsabilidad de liberar la estructura STGMEDIUM.
virtual void System.Runtime.InteropServices.ComTypes.IDataObject.GetData(System::Runtime::InteropServices::ComTypes::FORMATETC % formatetc, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::STGMEDIUM % medium) = System::Runtime::InteropServices::ComTypes::IDataObject::GetData;
void IDataObject.GetData (ref System.Runtime.InteropServices.ComTypes.FORMATETC formatetc, out System.Runtime.InteropServices.ComTypes.STGMEDIUM medium);
abstract member System.Runtime.InteropServices.ComTypes.IDataObject.GetData : FORMATETC * STGMEDIUM -> unit
override this.System.Runtime.InteropServices.ComTypes.IDataObject.GetData : FORMATETC * STGMEDIUM -> unit
Sub GetData (ByRef formatetc As FORMATETC, ByRef medium As STGMEDIUM) Implements IDataObject.GetData
Parámetros
- formatetc
- FORMATETC
Puntero a una estructura FORMATETC, pasada por referencia, que define el formato, medio y dispositivo de destino que debe utilizarse al pasar los datos. Es posible especificar más de un medio utilizando el operador booleano OR, lo que permite al método elegir el mejor medio entre los especificados.
- medium
- STGMEDIUM
El resultado que devuelve este método contiene un puntero a la estructura STGMEDIUM que indica el medio de almacenamiento que contiene los datos devueltos a través de su miembro tymed y la responsabilidad para liberar el medio a través del valor de su miembro pUnkForRelease. Si pUnkForRelease es null
, el receptor del medio es el responsable de liberarlo; de lo contrario, pUnkForRelease señala a la interfaz IUnknown
en el objeto adecuado de modo que se pueda llamar a su método Release
. El medio debe ser asignado y rellenado por GetData(FORMATETC, STGMEDIUM). Este parámetro se pasa sin inicializar.
Implementaciones
Excepciones
No hay suficiente memoria para realizar esta operación.
Comentarios
Este miembro es una implementación explícita de un miembro de interfaz. Sólo se puede usar cuando DataObject se convierte en una interfaz IDataObject.