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