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 функції в на посилання на OLE 2 програміста, Том 1.

Огляд COleDataSourceЧлени класу | Ієрархічна діаграма

Дивіться також COleDataSource::DelaySetData, COleDataSource::OnRenderData, COleDataSource::OnRenderFileData, COleDataSource::OnRenderGlobalData, COleServerItem::OnSetData

Index