RpcStructInstance.InvokeRpcMethodAsync Method (String, .Object., CancellationToken)

Invokes the specified RPC Method asynchronously

Namespace:  TwinCAT.Ads.TypeSystem
Assembly:  TwinCAT.Ads (in TwinCAT.Ads.dll) Version: 6.0.95+cf8c3f5

Syntax

C#

public Task<ResultRpcMethodAccess> InvokeRpcMethodAsync(
    string methodName,
    Object[]? inParameters,
    CancellationToken cancel
)

Parameters

methodName

Type: System.String
The method name.

inParameters

Type: .System.Object.
The parameters.

cancel

Type: System.Threading.CancellationToken
The cancellation token

Return Value

Type: Task.ResultRpcMethodAccess.
A task that represents the asynchronous 'InvokeRpcMethod' operation. The ResultRpcMethodAccess results contains the return value (ReturnValue) together with the output parameters. The succeeded communication is indicated by the ErrorCode property (ErrorCode) after the communication.

Implements

IRpcCallableInstance.InvokeRpcMethodAsync(String, .Object., CancellationToken)

Remarks

Because this overload doesn't provide any AnyTypeSpecifier specifications, only primitive datatypes will be correctly marshalled by this method. Complex types will fall back to byte[] arrays.

Examples

The following sample shows how to call (Remote Procedures / Methods) within the PLC.

Dynamic Tree Mode

class RpcCallVirtualProgram
{
    /// <summary>
    /// Defines the entry point of the application.
    /// </summary>
    /// <param name="args">The arguments.</param>
    static void Main(string[] args)
    {
    // Get the AdsAddress from command-line arguments
    AmsAddress address = ArgParser.Parse(args);

    using (AdsClient client = new AdsClient())
    {
        //client.Synchronize = false;

        // Connect to the target device
        client.Connect(address);

        SymbolLoaderSettings settings = new SymbolLoaderSettings(SymbolsLoadMode.VirtualTree);
        ISymbolLoader loader = SymbolLoaderFactory.Create(client, settings);

        // Get the Symbols (Dynamic Symbols)

        IRpcStructInstance main = (IRpcStructInstance)loader.Symbols["MAIN"]; // Gets the MAIN Instance of the PLC Program

        // Call a Method that has the following signature (within MAIN Program)
        /*  {attribute 'TcRpcEnable'}
        METHOD PUBLIC M_Add : INT
        VAR_INPUT
            i1 : INT := 0;
            i2 : INT := 0;
        END_VAR 
        */

        short result = (short)main.InvokeRpcMethod("M_Add", new object[] {(short) 3, (short) 4});

        // Call a Method that has no parameter and returns VOID
        main.InvokeRpcMethod("M_Method1", new object[] {});

        //Browsing RpcMethods
        foreach(IRpcMethod method in main.RpcMethods)
        {
        string methodName = method.Name;

        foreach(IRpcMethodParameter parameter in method.Parameters)
        {
            string parameterName = parameter.Name;
            string parameterType = parameter.TypeName;
        }
        }
    }
    }
}

Reference

RpcStructInstance Class

InvokeRpcMethodAsync Overload

TwinCAT.Ads.TypeSystem Namespace