The RenameCalendar method renames a specified calendar event.
[id(5), helpstring("method RenameCalendar")] HRESULT RenameCalendar(
[in] BSTR bstrOldCalendarName,
[in] BSTR bstrNewCalendarName
);
bstrOldCalendarName: A string that specifies the current name of the calendar event to be renamed.
If this parameter is NULL, E_INVALIDARG MUST be returned.
bstrNewCalendarName: A string that specifies the new name of the calendar event.
Return Values: This method returns 0x00000000 for success or a negative HRESULT value (in the following table or in [MS-ERREF] section 2.1.1) if an error occurs.
|
Return value/code |
Description |
|---|---|
|
0x00000000 S_OK |
Operation successful. |
|
0x80070057 E_INVALIDARG |
One or more arguments are invalid. |
|
0xC1FF006F WRM_ERR_ID_VALUE |
The specified name contains characters that are invalid. The name cannot start with a hyphen ("-") and cannot contain spaces or any of the following characters:
|
|
0xC1FF0258 WRM_ERR_CAL_DUPLICATE_CALENDAR |
A calendar event with the specified name already exists. |
|
0xC1FF0259 WRM_ERR_CAL_UNKNOWN_CALENDAR |
The specified calendar event does not exist. |
|
0xC1FF025A WRM_ERR_CAL_NAME_TOO_LONG |
The calendar name has exceeded an implementation-defined limit.<63>. |
Additional IWRMCalendar interface methods are specified in section 3.2.4.4.