IOleAdviseHolder::SendOnRename

Sends IAdviseSink::OnRename notifications to all advisory sinks currently registered with the advise holder.

HRESULT SendOnRename(
  IMoniker *pmk  //Pointer to an interface on the new moniker
);

Parameter

pmk: [in] Pointer to the new full moniker of the object.

Return Value

S_OK: Advise sinks were sent IAdviseSink::OnRename notifications.

Remarks

IOleAdviseHolder::SendOnRename calls IAdviseSink::OnRename to advise the calling object, which must have already established an advisory connection, that the object has a new moniker. If you are using the OLE advise holder (having obtained a pointer through a call to CreateOleAdviseHolder), you can call IOleAdviseHolder::SendOnRename in the implementation of IOleObject::SetMoniker, when you have determined that the operation is successful.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in oleidl.h.