Méthode IAdviseSink2 ::OnLinkSrcChange (objidl.h)

Avertit le conteneur qui a inscrit le récepteur d’avis qu’une source de lien a changé (nom ou emplacement), ce qui permet au conteneur de mettre à jour le moniker du lien.

Syntaxe

void OnLinkSrcChange(
  [in] IMoniker *pmk
);

Paramètres

[in] pmk

Pointeur vers l’interface IMoniker identifiant la source d’un objet lié.

Valeur de retour

None

Remarques

Un conteneur d’objets liés implémente cette méthode pour recevoir une notification en cas de modification du moniker de sa source de lien.

OnLinkSrcChange est appelé par l’objet de lien OLE lorsqu’il reçoit la notification OnRename de l’application link-source (object). L’objet link met à jour son moniker et envoie la notification OnLinkSrcChange aux conteneurs qui ont implémenté IAdviseSink2.

Remarques aux implémenteurs

Rien n’empêche un objet link de notifier son conteneur de la modification du moniker en appelant OnRename au lieu de OnLinkSrcChange. Toutefois, dans la pratique, la surcharge d’OnRename pour signifier que le moniker d’un objet de liaison a changé ou que le nom du serveur d’un objet incorporé a changé rend difficile pour les applications de déterminer l’un de ces événements qui s’est produit. Si les deux événements déclenchent un traitement différent, comme ce sera souvent le cas, l’appel d’une méthode différente pour chacun d’eux facilite grandement la tâche de déterminer l’événement qui s’est produit.

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

Voir aussi

IAdviseSink2

IAdviseSink ::OnRename