COleDataSource::OnSetData

Виртуальный BOOL OnSetData ( LPFORMATETC lpFormatEtc, LPSTGMEDIUM lpStgMedium, BOOL bRelease );

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

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

Параметры

lpFormatEtc

Указывает на структура FORMATETC , указав формат, в котором производится замена данных.

lpStgMedium

Указывает на STGMEDIUM структуры, содержащие данные, которые будут заменять текущее содержимое объекта COleDataSource.

bRelease

Указывает, кто имеет право собственности среды хранения после завершения вызова функции. Вызывающая сторона решает, кто несет ответственность за освобождение ресурсов, выделенных со среды хранения. Вызывающий объект делает это путем настройки bRelease. Если bRelease не равен нулю, источник данных принимает собственность, освобождая средне-и когда он закончил, используя его. Когда bRelease равно 0, вызывающая сторона сохраняет право собственности и источника данных можно использовать среду хранения только на время вызова.

Примечания

Вызывается платформой для установки или замены данных в объекте COleDataSource в указанном формате. Источник данных не принимает владение данных до тех пор, пока он успешно получает его. То есть она не принимает ответственность, если OnSetData возвращает 0. Если источник данных использует права собственности, он освобождает среду хранения путем вызова ReleaseStgMedium функция.

Реализация по умолчанию не выполняет никаких действий. Переопределите эту функцию для замены данных в указанном формате. Это передовые переопределения.

Для получения дополнительной информации, смотрите STGMEDIUM и структур FORMATETC и ReleaseStgMedium и IDataObject::GetData функционирует в 2 справочнике программиста OLE, том 1.

Обзор COleDataSourceЧлены класса | Иерархическая схема

См. также COleDataSource::DelaySetData, COleDataSource::OnRenderData, COleDataSource::OnRenderFileData, COleDataSource::OnRenderGlobalData, COleServerItem::OnSetData

Index