IOleAdviseHolder::SendOnRename

This method sends IAdviseSink::OnRename notifications to all advisory sinks currently registered with the advise holder.

HRESULT SendOnRename( 
  IMoniker* pmk
);

Parameters

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

Return Values

S_OK indicates that advise sinks were sent OnRename notifications.

Remarks

SendOnRename calls 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 SendOnRename in the implementation of IOleObject::SetMoniker, when you have determined that the operation is successful.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Oleidl.h, Oleidl.idl.
Link Library: Oleaut32.lib, Uuid.lib.

See Also

IOleAdviseHolder | CreateOleAdviseHolder | Determining Supported COM APIs | IAdviseSink::OnRename | IOleObject::SetMoniker

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.