IDataObject.GetData(FORMATETC, STGMEDIUM) Метод

Определение

Получает данные из исходного объекта данных.Obtains data from a source data object. Метод GetData(FORMATETC, STGMEDIUM), который вызывается объектом-получателем данных, обрабатывает данные, описанные в заданной структуре FORMATETC, и передает их через заданную структуру STGMEDIUM.The GetData(FORMATETC, STGMEDIUM) 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. Затем вызывающий объект несет ответственность за освобождение структуры STGMEDIUM.The caller then assumes responsibility for releasing the STGMEDIUM structure.

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

Параметры

format
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. С помощью логического оператора OR можно задать более одной среды передачи, разрешив методу выбирать лучшую среду передачи среди заданных.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.

medium
STGMEDIUM

При возвращении данного метода содержит указатель на структуру STGMEDIUM, задающий среду хранения, содержащую возвращенные данные посредством своего элемента tymed, и ответственность за освобождение среды передачи через значение своего элемента pUnkForRelease.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. Если pUnkForRelease равняется null, получатель среды передачи отвечает за ее освобождение; в противном случае pUnkForRelease указывает на интерфейс IUnknown в соответствующем объекте, так чтобы можно было вызвать его метод Release.If pUnkForRelease is null, 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. Среда передачи должна быть выделена и заполнена с помощью GetData(FORMATETC, STGMEDIUM).The medium must be allocated and filled in by GetData(FORMATETC, STGMEDIUM). Этот параметр передается неинициализированным.This parameter is passed uninitialized.

Комментарии

Дополнительные сведения о см IDataObject::GetData . в библиотеке MSDN.For more information about IDataObject::GetData, see the MSDN Library.

Применяется к