dpDisconnectExt()

The function disconnects the work function whenever the passed datapoint values/attributes change.

Synopsis

int dpDisconnectExt([class object,] string|function_ptr work, dyn_string dpConn, dyn_string dpExt);

Parameters

Parameter Description
object An object of a Control++ class.
work

Name of the callback function ("work function") that is called when datapoint values change.

Or

The name of a function pointer to the work function (callback function).
dpConn List of the datapoints whose value change disconnect the work function.
dpExt

List of the extended datapoints.

Return Value

The function dpDisconnectExt() returns 0 and in the event of a failure it returns -1.

Error

Use the function getLastError() to retrieve errors. The function throwError() can be used to write an error message to the PVSS_II.log log file.

Note:
Note that when using the function getLastError(), use it directly after the function call of the dpConnect() as shown in the example below since the function getLastError returns the errors of the last function call.

Description

If a value of a datapoint element that belongs to the trigger list is changed, the function disconnects the work function. The work function is no longer executed spontaneously.

If a value of a datapoint element that belongs to the extended list is changed, the function does not disconnect the work function.

If the list of trigger datapoint elements is empty, an error is raised.

Assignment

Datapoint Functions, Waiting Control Functions

Availability

UI, CTRL