ST_STATUS appendPointValue(
CDataHub& point, LPCTSTR str )
;
ST_STATUS appendPointValue(
LPCTSTR pointname, LPCTSTR str )
;
Exception appendPointValue(
DataHub point, String str )
;
Exception appendPointValue(
String pointname, String str )
;
A pointer structure of type DataHubPoint. The name, seconds and nanoseconds members must be valid.
The name of the point. The point timestamp is automatically set to the current time.
A string to append to the current point string value.
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.
This method appends the specified string to the current string value of the DataHub point. If the DataHub point is not a string type (PT_TYPE_STRING), then the DataHub will respond with an error, and onError will be called with the following arguments:
status: ST_WRONG_TYPE |
msg: "Wrong type" |
If the DataHub point does not exist, then the DataHub will respond with an error, and onError will be called with the following arguments:
status: ST_NO_POINT |
msg: "Point does not exist" |
Copyright © 1995-2010 by Cogent Real-Time Systems, Inc. All rights reserved.