IOleAdviseHolder::SendOnRename method (oleidl.h)
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
[in] pmk
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
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | oleidl.h |