bstr_data_point_put_value(3) — Subroutines
Name
bstr_data_point_put_value − Writes the value of a Data_Point (VODB only).
Syntax
bstr_t_status bstr_data_point_put_value (
bstr_t_reference ∗data_point,
bstr_t_value value,
bstr_t_rcb ∗control);
Description
The bstr_data_point_put_value procedure updates the current value of data_point with the value specified in the value argument. Both simple and complex datatype values can be written with a single call to the bstr_data_point_put_value procedure.
If the Data_Point is associated with one or more Triggers, updating its current value causes the enabled Triggers to be evaluated. This may lead to the declaration of Events. If data_point is linked as producer to one or more other Data_Points, writing its value can cause the value of the linked Data_Point to be updated.
Arguments
data_point
access: read
The reference to the Data_Point whose current value is to be updated.
value
access: read
The address of a buffer containing the value to be written. The allocated buffer must be consistent with the datatype associated with data_point.
control
access: read
The address of an optional request control block.
Return Values
| BSTR_S_ABORTED | Operation aborted |
| BSTR_S_BAD_PARAMETER | Bad parameter value |
| BSTR_S_BAD_REFERENCE | Bad reference |
| BSTR_S_COMMUNICATION_ERROR | Communication error |
| BSTR_S_COM_PC_SIZE_MISMATCH | Number of bytes requested does not match the number of bytes returned |
| BSTR_S_DEVICE_SERVICES_NOT_AVAILABLE | Device Services are not available |
| BSTR_S_FINISH | Request aborted by bstr_finish |
| BSTR_S_INTERNAL_ERROR | Internal error |
| BSTR_S_INTR | Operation interrupted |
| BSTR_S_INVALID_OPERATION | Invalid operation |
| BSTR_S_INVALID_RCB | Invalid Request Control Block |
| BSTR_S_INVALID_USAGE | Invalid reference usage |
| BSTR_S_NORMAL | Normal successful completion |
| BSTR_S_NO_MEMORY | Insufficient virtual memory |
| BSTR_S_OBJECT_NOT_IN_SET | The variable is not in the locked set |
| BSTR_S_READ_ONLY | The variable cannot be written |
| BSTR_S_SERVER_NOT_REACHABLE | Server not reachable |
| BSTR_S_TIMEOUT | Timeout expired |
| BSTR_S_TOO_MANY_REQUESTS | Too many pending requests |