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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | objidl.h |