dpDisconnectExt()

The function disconnects the work function whenever the passed data point 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 data point values change. Or The name of a function pointer to the work function (callback function).
dpConn	List of the data points whose value change disconnect the work function.
dpExt	List of the extended data points.

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 data point 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 data point element that belongs to the extended list is changed, the function does not disconnect the work function.

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

Assignment

Data point Functions, Waiting Control Functions

Availability

UI, CTRL