setPointSecurity

setPointSecurity — sets the security attributes of a Cascade DataHub point.

Syntax

For C++:

ST_STATUS setPointSecurity(CDataHubPoint&  point,
 int  security);
ST_STATUS setPointSecurity(LPCTSTR  pointname,
 int  security);

For Java and C#:

Exception setPointSecurity(CDataHubPoint&  point,
 int  security);
Exception setPointSecurity(String  pointname,
 int  security);

Parameters

point

A DataHubPoint object. The name and security members must be valid.

pointname

The name of the point.

security

The new security level to which the DataHub point will be set.

Returns

For C++:

    ST_OK if the command was successfully sent to the DataHub. Since the command is sent asynchronously, the actual success or failure of the command must be determined through the onSuccess or onError message handlers.

    ST_NO_TASK if a connection to the DataHub does not exist.

    ST_ERROR if the connection socket is unable to send the message.

Description

This method sets the security attributes of a DataHub point. An update to a DataHub point will be rejected unless the security level associated with the new point value is greater than or equal to the corresponding DataHub point. The default DataHub point security level is 0.

See Also

setPointLock