COleServerItem::OnRenderGlobalData

Статья
02/20/2013

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

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.