IAdviseSink2::OnLinkSrcChange method (objidl.h)

Article
02/22/2024

Notifies the container that registered the advise sink that a link source has changed (either name or location), enabling the container to update the link's moniker.

Syntax

void OnLinkSrcChange(
  [in] IMoniker *pmk
);

Parameters

[in] pmk

A pointer to the IMoniker interface identifying the source of a linked object.

Return value

None

Remarks

A container of linked objects implements this method to receive notification in the event of a change in the moniker of its link source.

OnLinkSrcChange is called by the OLE link object when it receives the OnRename notification from the link-source (object) application. The link object updates its moniker and sends the OnLinkSrcChange notification to containers that have implemented IAdviseSink2.

Notes to Implementers

Nothing prevents a link object from notifying its container of the moniker change by calling OnRename instead of OnLinkSrcChange. In practice, however, overloading OnRename to mean either that a link object's moniker has changed or that an embedded object's server name has changed makes it difficult for applications to determine which of these events has occurred. If the two events trigger different processing, as will often be the case, calling a different method for each makes the job of determining which event occurred much easier.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	objidl.h