Метод 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 .

Требования

См. также раздел

IAdviseSink::OnDataChange

IDataAdviseHolder