MoveTo
method
Moves the item to another location.
Syntax
C++
HRESULT MoveTo(
IERUItem* Destination,
LONG MoveFlags)
Scripting languages
Object.MoveTo
Destination
as IERUItem,
MoveFlags
as Long |
Parameters
Destination
The destination item that this item should be moved into.
MoveFlags
One or more values chosen from the ERUMoveFlag
enum, logically OR'ed together.
Return value
C++
The return code. |
Scripting languages
None. |
Remarks
You can move items within
a single Room, or from one room to another
in the same Facility, but not across
Facilities.
If moving across rooms and
the Open/Edit access lists or the Route access list of the source item
contains members from the source room who are not members in the target
room, they are removed from that access list.
If the access scope is erScopeList
and this procedure results in the removal of all members from the access
list, the access scope will revert to erCoordinatorsOnly.
If the source or the target
objects do not support moving, or the combination of the two is not supported,
this method returns EROOM_E_INVALIDOPERATION.
Note that:
Not all item types can be
moved.
Not all item types can be
destinations.
Some item types cannot be
moved into some other item types (e.g. you can't move a Poll into a Comment).
If the item's name is not
unique in the destination container, and the value erMoveFlagMakeNameUnique
is not included in the MoveFlags parameter, the error EROOM_E_DUPLICATE
name is returned.
This method replaces IERUContainer::Move. |
Home
Applies to
IERUItem |