Método IDataAdviseHolder::SendOnDataChange (objidl.h)

Envía notificaciones a cada receptor de asesoramiento para el que se establece una conexión mediante una llamada al método IAdviseSink::OnDataChange para cada receptor de asesoramiento que está siendo controlado actualmente por esta instancia del objeto del titular del aviso.

Sintaxis

HRESULT SendOnDataChange(
  [in] IDataObject *pDataObject,
  [in] DWORD       dwReserved,
  [in] DWORD       advf
);

Parámetros

[in] pDataObject

Puntero a la interfaz IDataObject en el objeto de datos en el que los datos han cambiado. Este puntero se usa en llamadas posteriores a IAdviseSink::OnDataChange.

[in] dwReserved

Este parámetro está reservado y debe ser 0.

[in] advf

Contenedor para marcas de aviso que especifican cómo se realiza la llamada a IAdviseSink::OnDataChange . Estos valores de marca proceden de la enumeración ADVF. Normalmente, el valor de advf es NULL. La única excepción se produce cuando el objeto de datos se apaga y debe enviar una notificación final que incluya los datos reales a los receptores que han especificado ADVF_DATAONSTOP y ADVF_NODATA en su llamada a IDataObject::D Advise. En este caso, advf contiene ADVF_DATAONSTOP.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente.

Comentarios

El objeto de datos debe llamar a este método cuando detecta un cambio que sería de interés para un receptor de asesoramiento que haya solicitado previamente la notificación.

La mayoría de las notificaciones incluyen los datos reales con ellos. La única excepción es si la marca ADVF_NODATA se especificó anteriormente cuando la conexión se configuró inicialmente en el método IDataAdviseHolder::Advise .

Antes de llamar al método IAdviseSink::OnDataChange para cada receptor de asesoramiento, este método obtiene los datos reales llamando al método IDataObject::GetData a través del puntero especificado en el parámetro pDataObject .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	objidl.h

Consulte también

IAdviseSink::OnDataChange

IDataAdviseHolder