SE_stream_update_ordered

Prepares to update a set of rows

Usage syntax

LONG SE_stream_update_ordered
(SE_STREAM stream,
const CHAR *table,
LONG *sde_row_id,
const LONG *id_list,
LONG id_count,
SHORT num_columns,
const CHAR **columns);

Parameters
stream The stream handle
table The table
sde_row_id The identifier of the row in the table to update
id_list The IDs of the rows; must be specified in ascending order
id_count The number of row IDs
num_columns The number of columns to use when inserting data
columns The array of column names to use
Description

SE_stream_update_ordered prepares to update a set of rows when performing versioned edits. Unlike SE_stream_update_row, you have to specify the IDs of all the rows to update (the id_list), and you must pass the information in ascending row ID order. The table and id_list identify the table and rows that you plan to update. The columns argument specifies which columns to update.

The business and adds tables get queried for the id_list. Then, updates are done serially for each row. Use sde_row_id to set the current row that you are updating.

For example, if you pass an id_list of 1,2,3,4,5, the first update is done on the row with an ID of 1. Therefore, 1 is the value of sde_row_id for that update. Then the next update is done for row ID 2. In that case, the sde_row_id value is 2.

If sde_row_id does not match the id_list, SE_ROW_OUT_OF_SEQUENCE is returned by SE_stream_flush_buffered_writes or SE_stream_execute.

Returns

SE_SUCCESS
SE_FAILURE

SE_CONNECTION_IN_USE

SE_CONNECTION_LOCKED

SE_DB_IO_ERROR

SE_INVALID_LAYER_NUMBER

SE_INVALID_PARAM_VALUE

SE_INVALID_POINTER

SE_INVALID_STREAM

SE_LAYER_NOEXIST

SE_NET_FAILURE

SE_NO_PERMISSIONS

SE_OUT_OF_CLMEM

SE_OUT_OF_SVMEM

SE_SDE_NOT_STARTED

SE_STREAM_IN_PROGRESS