Méthode IDataAdviseHolder ::SendOnDataChange (objidl.h)
Envoie des notifications à chaque récepteur de conseil pour lequel une connexion est établie en appelant la méthode IAdviseSink ::OnDataChange pour chaque récepteur de conseil actuellement géré par cette instance de l’objet de titulaire de conseil.
Syntaxe
HRESULT SendOnDataChange(
[in] IDataObject *pDataObject,
[in] DWORD dwReserved,
[in] DWORD advf
);
Paramètres
[in] pDataObject
Pointeur vers l’interface IDataObject sur l’objet de données dans lequel les données viennent de changer. Ce pointeur est utilisé dans les appels suivants à IAdviseSink ::OnDataChange.
[in] dwReserved
Ce paramètre est réservé et doit être 0.
[in] advf
Conteneur pour les indicateurs de conseil qui spécifient la façon dont l’appel à IAdviseSink ::OnDataChange est effectué. Ces valeurs d’indicateur proviennent de l’énumération ADVF. En règle générale, la valeur d’advf est NULL. La seule exception se produit lorsque l’objet de données s’arrête et doit envoyer une notification finale qui inclut les données réelles aux récepteurs qui ont spécifié ADVF_DATAONSTOP et ADVF_NODATA dans leur appel à IDataObject ::D Advise. Dans ce cas, advf contient ADVF_DATAONSTOP.
Valeur retournée
Cette méthode retourne S_OK en cas de réussite.
Remarques
L’objet de données doit appeler cette méthode lorsqu’il détecte une modification qui pourrait intéresser un récepteur d’avis qui a précédemment demandé une notification.
La plupart des notifications incluent les données réelles qui les accompagnent. La seule exception est que l’indicateur ADVF_NODATA a été spécifié précédemment lors de la configuration initiale de la connexion dans la méthode IDataAdviseHolder ::Advise .
Avant d’appeler la méthode IAdviseSink ::OnDataChange pour chaque récepteur de conseil, cette méthode obtient les données réelles en appelant la méthode IDataObject ::GetData via le pointeur spécifié dans le paramètre pDataObject .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | objidl.h |