RouteTo method

Moves an Item to the destination identified by the Routing Target, subject to routing access control.

Syntax

C++

HRESULT 
 RouteTo(

   IERURoutingTarget* pTarget,

   LONG RouteFlags)

Scripting languages

Object.RouteTo

   Target as IERURoutingTarget,

   RouteFlags as Long

Parameters

pTarget

The Routing Target to use when routing the item to its destination

RouteFlags

In V. 4 and beyond, you must specify the erRouteFlagMakeNameUnique member of the ERURouteFlag. (The erRouteFlagNone member is obsolete.) If you do not specify erRouteFlagMakeNameUnique, the method will fail.

Return value

C++

The return code.

Scripting languages

None.

Remarks

If the Item does not support routing, or the Routing Target does not support containment of the source Item's type, then the error EROOM_E_INVALIDOPERATION is returned.
If the item's name is not unique in the destination container and the value erRouteFlagMakeNameUnique is not included in the RouteFlags parameter, the error EROOM_E_DUPLICATE name is returned.

Home

Applies to
IERUItem