Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |