IOleAdviseHolder::SendOnRename (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

HRESULT SendOnRename( 
  IMoniker* pmk
);

Parameters

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

Return Value

S_OK indicates that advise sinks were sent OnRename notifications.

Remarks

SendOnRename calls OnRename to advise the calling object, which must have 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

Header Oleidl.h, oleidl.idl
Library oleaut32.lib, uuid.lib
Windows Embedded CE Windows CE 2.0 and later

See Also

Reference

IOleAdviseHolder
CreateOleAdviseHolder
IAdviseSink::OnRename
IOleObject::SetMoniker

Concepts

Determining Supported COM APIs