Router.SetRoutingRule

Router     See also    

Defines next node to which messages addressed to host specified in Address parameter.

Declaration

[C++]
    void SetRoutingRule(char *Address, char* RouteTo);

[Pascal]
    procedure SetRoutingRule(Address : string; RouteTo : string);

[VB6]
    Sub SetRoutingRule(Address As String, RouteTo As String)

[ActiveX]
    HRESULT _stdcall SetRoutingRule([in] BSTR Address, [in] BSTR RouteTo);

[C#]
    public void SetRoutingRule(string Address, string RouteTo);

[VB.NET]
    Public Sub SetRoutingRule(ByVal Address As String, ByVal RouteTo As String)

[Java]
    public synchronized void SetRoutingRule(String Address, String RouteTo);

[Java ME]
    public synchronized void SetRoutingRule(String Address, String RouteTo);

[Palm]
    void SetRoutingRule(char *Address, char* RouteTo);

[DLL]
    void __stdcall MCRouterSetRoutingRule(HMCRouter h, const char* Address, const char* RouteTo);

Parameters

• [DLL] h - handle to the Router object that was returned by Create method

• Address - final destination address.
• RouteTo - defines intermediate knot to which all messages addressed to host specified in Address parameter will be sent.

Description

    Use SetRoutingRule method to specify route for messages addressed to host specified in Address parameter. Note, that previous rule for the given Address is replaced.

    Address parameter has a form of

<Transport name>:<destination messenger name>
destination messenger name can be some specific address or * (any name).

Only one step in the route can be specified. See Routing description for details.