| SE_stream_bind_output_column | |
Binds a column to an output data location for fetching a row
LONG SE_stream_bind_output_column
(SE_STREAM stream,
SHORT column,
void *data,
SHORT *indicator);
| stream | The stream handle |
| column | The column number to bind; columns numbers start with the number 1. |
| data | Pointer to the bind variable to use as output data for the column when the stream is executed |
| indicator | Pointer to the variable that indicates whether the column value is NULL or not NULL |
SE_stream_bind_output_column identifies data pointers that are used as the output bind variable and indicator value for data retrieved from a table or layer. This function simply records the address of the pointers; the actual values (contents) of the pointers are set when SE_stream_fetch is called. Remember that SE_SHAPE is a pointer, so you are binding an SE_SHAPE variable, not an SE_SHAPE * variable.
SE_stream_bind_output_column can only be called after initializing a stream with a query operation and before calling SE_stream_fetch.
Once you call SE_stream_bind_output_column for a specified column, you cannot call any of the SE_stream_get_* functions for that column.
An SE_INVALID_POINTER error is returned if the data or indicator pointers are NULL.
Once a fetch is done, if the column for the retrieved row is NULL, the indicator value is SE_IS_NULL_VALUE; otherwise, it is SE_IS_NOT_NULL_VALUE.
SE_SUCCESS
SE_BIND_CONFLICT
SE_CONNECTION_LOCKED
SE_CONNECTION_IN_USE
SE_FAILURE
SE_FUNCTION_SEQUENCE_ERROR
SE_INVALID_PARAM_VALUE
SE_INVALID_POINTER
SE_INVALID_SHAPE_OBJECT
SE_INVALID_STREAM
SE_INVALID_STREAM_TYPE
SE_SDE_NOT_STARTED