Export (0) Print
Expand All

IOleAdviseHolder::SendOnRename method

Sends notification to all advisory sinks currently registered with the advise holder that the name of object has changed.

Syntax


HRESULT SendOnRename(
  [in]  IMoniker *pmk
);

Parameters

pmk [in]

A pointer to the new full moniker of the object.

Return value

This method returns S_OK if advise sinks were sent IAdviseSink::OnRename notifications.

Remarks

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

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.Idl

IID

IID_IOleAdviseHolder is defined as 00000111-0000-0000-C000-000000000046

See also

IAdviseSink::OnRename
IOleAdviseHolder

 

 

Community Additions

ADD
Show:
© 2014 Microsoft