Поделиться через


COleServerItem::OnRenderGlobalData

Вызываемый платформой для получения данных в указанном формате, когда указанный носитель записи глобальная память.

virtual BOOL OnRenderGlobalData( 
   LPFORMATETC lpFormatEtc, 
   HGLOBAL* phGlobal  
);

Параметры

  • lpFormatEtc
    Указатель на структуру FORMATETC, определяющий формат, в котором запрашиваются сведения.

  • phGlobal
    Указатель на дескриптор к глобальной памяти, в которой данные необходимо вернуть. Если память не была выделена, то этот параметр может быть NULL.

Возвращаемое значение

Ненулевой, если успешно; в противном случае – значение 0.

Заметки

Заданный формат одного ранее помещенное в объекте COleDataSource с помощью функции-члена DelayRenderData для отложенной обработки. Реализация по умолчанию просто возвращает FALSE этой функции.

Если phGlobalNULL, то новое HGLOBAL должно быть выделен и возвращается в phGlobal. В противном случае - значение HGLOBAL указанный phGlobal должно быть заполнено с данными. Количество данных, помещенных в HGLOBAL не должен превышать текущий размер блока памяти. Кроме того, нельзя reallocated к крупноразмерному.

Это расширенный переопределяемый метод. Переопределите эта функция позволяет предоставить данные в формате, и среде передачи. В зависимости от имеющихся данных, можно переопределить одна из других версий этой функции. Если требуется обработка нескольких носителей записи, переопределите OnRenderData. Если данные в файле или в переменной размера, следует переопределить OnRenderFileData.

Дополнительные сведения см. в разделе IDataObject::GetData и FORMATETC в Windows SDK.

Требования

Header: afxole.h

См. также

Ссылки

Класс COleServerItem

Диаграмма иерархии

COleServerItem::OnRenderData