Метод IDataAdviseHolder::SendOnDataChange (objidl.h)
Отправляет уведомления в каждый приемник рекомендаций, для которого установлено соединение, путем вызова метода IAdviseSink::OnDataChange для каждого приемника рекомендаций, который в настоящее время обрабатывается этим экземпляром объекта владельца рекомендаций.
Синтаксис
HRESULT SendOnDataChange(
[in] IDataObject *pDataObject,
[in] DWORD dwReserved,
[in] DWORD advf
);
Параметры
[in] pDataObject
Указатель на интерфейс IDataObject на объекте данных, в котором только что были изменены данные. Этот указатель используется в последующих вызовах IAdviseSink::OnDataChange.
[in] dwReserved
Этот параметр зарезервирован и должен иметь значение 0.
[in] advf
Контейнер для флагов рекомендаций, указывающих способ выполнения вызова IAdviseSink::OnDataChange . Эти значения флагов относятся к перечислению ADVF. Как правило, значение для advf равно NULL. Единственное исключение возникает, когда объект данных завершает работу и должен отправить окончательное уведомление, включающее фактические данные, приемникам, которые указали ADVF_DATAONSTOP и ADVF_NODATA в вызове IDataObject::D Advise. В этом случае advf содержит ADVF_DATAONSTOP.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении.
Комментарии
Объект данных должен вызывать этот метод при обнаружении изменения, которое может представлять интерес для приемника рекомендаций, который ранее запросил уведомление.
Большинство уведомлений содержат фактические данные с ними. Единственное исключение — если флаг ADVF_NODATA был указан ранее при первоначальной настройке подключения в методе IDataAdviseHolder::Advise .
Перед вызовом метода IAdviseSink::OnDataChange для каждого приемника рекомендаций этот метод получает фактические данные путем вызова метода IDataObject::GetData с помощью указателя, указанного в параметре pDataObject .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | objidl.h |