description: Sets the value of one or more parameters for the current data table of a data set. Must be
preceeded by a call to SDDS_StartTable to initialize the table.
SDDS_table: Address of the SDDS_TABLE structure for the data set.
mode: A bit-wise combination of the constants SDDS_SET_BY_INDEX, SDDS_SET_BY_NAME,
SDDS_PASS_BY_VALUE, and SDDS_PASS_BY_REFERENCE, which are defined in
SDDS.h. One and only one of SDDS_SET_BY_INDEX and SDDS_SET_BY_NAME must be
set, indicating that the parameters to be set are indicated by index number or
by name, respectively. One and only one of SDDS_PASS_BY_VALUE and
SDDS_PASS_BY_REFERENCE must be set, indicating that the values for the parameters are
passed by value or by reference, respectively. The syntax for the four possible combinations
is:
Note that for data of type SDDS_STRING, pass-by-value means passing an item of type char
*, while pass by reference means passing an item of type char **.
return value: Returns 1 on success. On failure, returns 0 and records an error message.