createPoint

createPoint — creates a Cascade DataHub point.

Syntax

For C++:

ST_STATUS createPoint(CDataHubPoint&  point);

ST_STATUS createPoint(LPCTSTR pointname);

For Java and C#:

Exception createPoint(DataHubPoint point);

Exception createPoint(String pointname);

Parameters

point

A DataHubPoint object. The name member must be valid.

pointname

The name of the point.

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 creates a DataHub point. The point quality is set to PT_QUALITY_BAD and the timestamp is set to 0. The point type and value are undefined.

See Also

registerPoint, unregisterPoint