ITcSysManager::LinkVariables

The LinkVariables() method links two variables, which are specified by their names. The two variables represented by their tree path name will be linked. The path names must have the same syntax as described in ITcSysManager::LookupTreeItem. The same shortcuts can be used.

HRESULT LinkVariables(BSTRbstrV1, BSTRbstrV2, longoffs1, longoffs2, longsize);

Parameters

bstrV1

[in] path name of the first variable. The full path name is required, and each branch must be separated by a circumflex accent '^' or a tab.

bstrV2

[in] path name of the second variable. The full path name is required, and each branch must be separated by a circumflex accent '^' or a tab.

offs1

[in, defaultvalue(0)] bit offset of the first variable (used if the two variables have different sizes or not the whole variable should be linked).

offs2

[in, defaultvalue(0)] bit offset of the second variable.

size

[in, defaultvalue(0)] bit count how many bits should linked. If size is 0 the minimum of the variable size of variable one and two is used.

Return Values

S_OK

function returns successfully.

TSM_E_ITEMNOTFOUND (0x98510001)

one or both path name(s) does not qualify an existing tree item.

TSM_E_INVALIDITEMTYPE (0x98510002)

one or both tree item(s) is not a variable.

TSM_E_MISMATCHINGITEMS (0x98510004)

the two variables cannot link together. Maybe you have tried to link an output of one task with an output of another task or an output of a task with an input of a device or to variables of the same owner.

E_INVALIDARG

the values of offs1, offs2 and/or size does not fit to the variables.