Metodo IDataAdviseHolder::SendOnDataChange (objidl.h)

Invia notifiche a ogni sink consigliato per il quale esiste una connessione stabilita chiamando il metodo IAdviseSink::OnDataChange per ogni sink attualmente gestito da questa istanza dell'oggetto del titolare del consiglio.

Sintassi

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

Parametri

[in] pDataObject

Puntatore all'interfaccia IDataObject nell'oggetto dati in cui i dati sono stati appena modificati. Questo puntatore viene usato nelle chiamate successive a IAdviseSink::OnDataChange.

[in] dwReserved

Questo parametro è riservato e deve essere 0.

[in] advf

Contenitore per segnalare i flag che specificano come viene eseguita la chiamata a IAdviseSink::OnDataChange . Questi valori di flag provengono dall'enumerazione ADVF. In genere, il valore di advf è NULL. L'unica eccezione si verifica quando l'oggetto dati viene arrestato e deve inviare una notifica finale che include i dati effettivi ai sink che hanno specificato ADVF_DATAONSTOP e ADVF_NODATA nella chiamata a IDataObject::D Advise. In questo caso , advf contiene ADVF_DATAONSTOP.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo.

Commenti

L'oggetto dati deve chiamare questo metodo quando rileva una modifica che sarebbe di interesse per un sink consigliato che ha richiesto in precedenza la notifica.

La maggior parte delle notifiche include i dati effettivi. L'unica eccezione è se il flag ADVF_NODATA è stato specificato in precedenza quando la connessione è stata inizialmente configurata nel metodo IDataAdviseHolder::Advise .

Prima di chiamare il metodo IAdviseSink::OnDataChange per ogni sink di avviso, questo metodo ottiene i dati effettivi chiamando il metodo IDataObject::GetData tramite il puntatore specificato nel parametro pDataObject .

Requisiti

Vedi anche

IAdviseSink::OnDataChange

IDataAdviseHolder