SaCursorColStr binds a user variable to a database column.

In search operations, the user variable is updated to contain the value of the current row. Also, if search criteria are involved, this function is used to pass the values for them. In insert and update operations the new value for the column is taken from the user variable.

In search operations, the value stored to the user variable is a pointer to a local copy of the column data. The data pointer is valid until the next SaCursorOpen or SaCursorFree call, after which the pointer should not be referenced.

See SaCursorColDynData for a more detailed discussion of binding variables.

The following table describes the parameters:

SA_RC_SUCC or error code.