COleDataSource::OnSetData
Вызываемый платформой для задания или замены данных в COleDataSource объект в указанном формате.
virtual BOOL OnSetData(
LPFORMATETC lpFormatEtc,
LPSTGMEDIUM lpStgMedium,
BOOL bRelease
);
Параметры
lpFormatEtc
Указывает на FORMATETC составляющие определение формат, в котором данные заменить.lpStgMedium
Указывает на STGMEDIUM составляющих содержать данные, которые заменяют текущее содержимое объекта COleDataSource.bRelease
Указывает, кто имеет владельца носителя записи после завершения вызова функции. Вызывающая сторона решает, кто должен освободить ресурсы, выделенные именем носителя записи. Вызывающий оператор делает это путем установки bRelease. Если bRelease не равно нулю, то источник данных получает владение, освобождая среду передачи, когда он завершил его использование. При bRelease 0, вызывающий сохраняет владельца и источник данных может использовать носитель записи только на длительность обработки вызова.
Возвращаемое значение
Ненулевой, если успешно; в противном случае – значение 0.
Заметки
Источник данных не получает владение данных до тех пор, пока он не будет успешно получать его. То есть не имеет владельца, если OnSetData возвращают 0. Если источник данных имеет владельца, он освобождает носитель записи путем вызова функции ReleaseStgMedium.
Реализация по умолчанию не выполняет никаких действий. Переопределить эту функцию, чтобы заменить данные в указанном формате. Это расширенный переопределяемый метод.
Дополнительные сведения см. в разделе макета и STGMEDIUMFORMATETC и функции ReleaseStgMedium и IDataObject::GetData в Windows SDK*.*
Требования
Header: afxole.h
См. также
Ссылки
COleDataSource::OnRenderFileData