TipcMonExtSetReal16Array

Name

TipcMonExtReal16Array — add or update a field containing an array of type REAL16 in an RTclient’s MON_CLIENT_EXT_POLL_RESULT message

Synopsis

T_BOOL TipcMonExtSetReal16Array(field_name, data, size) 
T_STR field_name; 
T_REAL16 *data; 
T_INT4 size; 

Arguments

field_name — name of a field in the RTclient’s MON_CLIENT_EXT_POLL_RESULT message.

data — the RTclient information to write to field_name in the MON_CLIENT_EXT_POLL_RESULT message.

size — number of elements in the field.

Return Values

TRUE if the field was added or updated, FALSE otherwise.

Diagnostics

If TipcMonExtSetReal16Array fails, it returns FALSE and sets the global SmartSockets error number to one of:

Description

TipcMonExtSetReal16Array creates a field containing an array of type REAL16 in the RTclient’s MON_CLIENT_EXT_POLL_RESULT message to associate with one of the RTclient’s fields. If the field in the MON_CLIENT_EXT_POLL_RESULT message does not exist, it is created and updated with the value of data. If the field already exists in the MON_CLIENT_EXT_POLL_RESULT message, TipcMonExtSetReal16Array only updates it with the value of data.

Not all platforms fully support the REAL16 type. While some platforms can manipulate them as uninterpreted bytes, they can neither manipulate nor interpret them as numbers.

See Also

Use other TipcMonExt* APIs as necessary to define extension data in each RTclient that is polled by TipcMonClientExtPoll.

Examples

See the example for TipcMonClientExtPoll.