SE_state_new_edit

Create a new editing state, and prepare to edit the new state.

Usage syntax

LONG SE_state_new_edit_info (SE_CONNECTION handle, const SE_STATEINFO state, LONG parent_state_id, SE_STATEINFO result_state);

Parameters
handle The ArcSDE connection handle
state The state to create
parent_state_id The parent state for the state to be created; parent state may be open or closed
result_state The state as actually created
Description

This function creates a new editing state that is the child of a specified parent state. The parent state is closed if it is open. An exclusive lock is placed on the new state. A new transaction is started.

The parent state must be either owned by the current user or be public, or the current user must be SDE.

After the new state is created, a transaction is started just as it would be by calling SE_connection_start_transaction. Calling SE_connection_start_transaction immediately after calling SE_state_new_edit will result in a SE_TRANS_IN_PROGRESS error.

This function differs from SE_state_create, which only creates a new child state from a closed parent state.

Returns

SE_SUCCESS
SE_DB_IO_ERROR

SE_INVALID_STATE_ID

SE_INVALID_STATEINFO_OBJECT

SE_NET_FAILURE

SE_NO_PERMISSIONS

SE_OUT_OF_SVMEM

SE_PARENT_NOT_CLOSED

SE_STATE_NOEXIST

SE_TABLE_NOEXIST