IAdsHandle.CreateVariableHandleAsync Method

Determines the Symbol handle by its instance path asynchronously.

Namespace:  TwinCAT.Ads
Assembly:  TwinCAT.Ads.Abstractions (in TwinCAT.Ads.Abstractions.dll) Version: 6.0.328+39e3229

Syntax

C#

Task<ResultHandle> CreateVariableHandleAsync(
    string symbolPath,
    CancellationToken cancel
)

Parameters

symbolPath

Type: System.String
SymbolName / InstancePath.

cancel

Type: System.Threading.CancellationToken
The cancellation token.

Return Value

Type: Task.ResultHandle.
A task that represents the asynchronous 'CreateVariableHandle' operation. The ResultHandle parameter contains the variable handle (Handle) and the ErrorCode after execution.

Remarks

It is a good practice to release all variable handles after use to regain internal resources in the TwinCAT subsystem. The composite method to this CreateVariableHandleAsync(String, CancellationToken) is the DeleteVariableHandleAsync(UInt32, CancellationToken)

Reference

IAdsHandle Interface

TwinCAT.Ads Namespace

IAdsHandle.DeleteVariableHandleAsync(UInt32, CancellationToken)

IAdsHandle.TryCreateVariableHandle(String, UInt32.)

IAdsHandle.CreateVariableHandle(String)