The following is a list of the return codes in the C API. They include fatal errors, non-fatal warnings, and exit codes.
The current operation completed successfully.
A general ArcSDE system failure. Returned whenever the error is not trapped by a more specific indicator.
The pointer to SE_LAYERINFO is not initialized.
The given shape has no annotation.
The current shape stream has finished successfully. If this code is returned from a shape stream initiation call, no shapes were found.
The call to start the ArcSDE was not executed or did not complete successfully. The ArcSDE server must be started before calling the function that returned this code.
The specified shape was unchanged. If a shape modification function cannot correctly modify a shape, for whatever reason, it returns this code.
The number of allowed server tasks was exceeded and no more logins to the ArcSDE serverare allowed until a task completes. Returned by the SE_connection_create call only.
The number of allowed server connections was exceeded and no more logins to the ArcSDE server are allowed until a connection is closed. Returned by the SE_connection_create call only.
The ArcSDE I/O connection manager task has discontinued logins. No more logins to the ArcSDE server are allowed until an administrator changes the login mode. Returned by the SE_connection_create call only.
The user attempting to access the ArcSDE server does not have a valid login account on the ArcSDE host machine. Returned by the SE_connection_create call only.
A catastrophic error occurred during a client/server round-trip request and the connection between the client task and the server was severed. Almost any call that makes a round-trip request to the ArcSDE server task can return this code.
Returned when the application that made the call cannot bind itself to the associated server task. Returned by the SE_connection_create call only.
The function failed to complete because the server process was unable to allocate the memory needed to perform the function.
The function failed to complete because the client could not allocate enough dynamic memory to complete the task.
The call is somehow out of context or inappropriate. Under certain circumstances, some functions are illegal and are not allowed.
The caller does not have access to the specified object.
Exceeded the maximum number of allowed layers as defined in giomgr.defs.
The required layer specification is missing.
Returned from the layer-locking routines when the specified layer is already locked.
Returned from the layer creation function when the specified map layer already exists.
The user-specified map layer does not exist.
The function was prevented from performing its task because another user is using the layer.
The specified shape (LAYER:FID) doesn't exist.
The specified row doesn't exist in the specified map layer. Returned by shape retrieval functions.
The specified shape (LAYER:FID) exists.
An operation attempted to insert a shape into an existing row.
For this operation, both layers must be the same.
The caller does not have database permissions to perform the operation or function.
The specified column has a NOT NULL constraint.
Returned when a shape cannot be verified as valid.
The map layer number is outside the allowable range.
A shape entity type is invalid or not allowed for the operation or function.
The specified search method is not one of those defined.
The entity types or combinations in the entity type mask are invalid. Returned from the map layer creation routine.
A mismatch occurred in one of the bind/set/get functions.
One of the specified grid sizes is either too small or too large. Returned from the map layer creation routine.
The lock mode specified is not one of those supported.
The entity type of the shape is not one of the types allowed by the map layer definition. Returned from the store and replace shape routines.
Exceeded max points specified.
There are more points than allowed by the specified maximum points.
The specified DBMS table does not exist.
Returned from functions that attempt to access a column that does not exist. Sometimes returned after misspelling the name of the column.
A problem exists with the license manager.
All ArcSDE licenses are in use.
The specified value exceeds the valid range for the column.
The user-specified SQL where clause is invalid. The caller should confirm that the syntax and attribute names are correct. This is an old return code; use the new INVALID_SQL return code instead.
The user-specified SQL where clause is invalid. In most cases, returned because of syntax problems in the SQL string. You can call the extended error code immediately after this code is returned to inquire about the specific database error code.
The named logfile does not exist.
The caller does not have permission to access the specified logfile.
Returned from logfile I/O functions when the specified logfile handle is not open.
A logfile I/O operation resulted in an error. The caller can check the extended error code to get the errno value.
The function found no shapes to process. Usually returned because an empty logfile was specified.
No locks were found for the specified map layer. The caller may have specified lock modifications for a layer that does not have any locks defined.
The lock request was not granted because the request conflicted with another users lock.
No more locks can be granted because all system lock resources are being used. Also returned from functions that automatically impose locks to complete their tasks.
A database-level I/O error occurred. You can call the extended error code immediately after this code is returned to inquire about the specific database error code.
The function cannot be executed during a stream shape retrieval. Close the stream before calling this function.
The user specified an invalid data type for a column definition.
At least one of the shapes processed by the function violated one of the topological integrity rules. Returned from functions that to complete successfully require the topological integrity of shapes.
Returned from the attribute mask function when an unsupported DBMS data type is encountered.
The user specified an invalid column definition. For example, the user specifies a size of -1 for a column.
The user specified an invalid shape array buffer size.
An invalid envelope was specified. Returned when the envelope is NULL, has negative values, or a minimum value is larger than a maximum value.
Returned from functions that use temporary system files to perform their tasks. Indicates temporary file permission problems, inadequate disk space, or general temporary file I/O error conditions.
Storing the shape would create too many grid records which suggests that the grid size for the target map layer is too small. Returned from functions that store or replace shapes.
The run-time license for the ArcSDE installation on the specified server has expired. See the system administrator to update the ArcSDE license. Returned from the SE_connection_create function only.
Returned from the table creation function when the specified database table already exists.
Returned from the attribute index creation functions when an attribute index already exists.
The specified index does not exist.
Returned by functions that are passed pointers to data that are either NULL or invalid.
Returned from a function that was given an invalid parameter value. The function is unable to continue.
Returned by an overlay function that reduces all shapes to slivers, yielding no results. In most cases, you can adjust the sliver factor to fix this problem.
A user-initiated transaction is currently in progress. The operation cannot be performed until the transaction is committed or rolled back.
The iomgr has lost its connection to the underlying DBMS.
An attempt was made to store or replace a shape where the arc (startpt, midpt, endpt) already exists.
The given annotation object handle is invalid.
The user-specified point does not exist in the associated map shape.
The two given points are not adjacent in the associated map shape.
The point given as a midpoint along a path is invalid or does not exist.
The specified endpoint is invalid or cannot be located within the associated shape.
The given radius was too small to perform the operation.
The operation cannot be performed because the specified map layer is in LOAD_ONLY mode.
The LAYERS table does not exist.
An error occurred when creating or writing to an output file.
An attempt is made to store a BLOB that exceeds the maximum allowable size of the ArcSDE server as specified by the MAXBLOBSIZE parameter of the giomgr.defs file.
The specified source shape and corridor distance would result in a corridor with coordinates that exceed the valid coordinate range.
Returned by low-level code indicating an error in the integrity of a shape.
The specified function is not implemented yet but is intended for a future release.
The shape has a CAD entity.
The specified internal ArcSDE Transaction ID is invalid.
The table name entered for the layer definition is invalid. Valid table names must not be NULL.
The specified layer configuration keyword does not exist in the dbtune.sde configuration parameter file.
The release/version of the client application does not match the installed release/version of the ArcSDE server, or the installed release/version of the ArcSDE software does not match the release/version of the ArcSDE datasets. If the datasets are older than the ArcSDE server, you can update them with the admversion administration tool.
The VERSION table exists when it should not. This error occurs when you attempt to upgrade a server and the VERSION table already exists.
A column was specified for an insert/update operation but was not bound (by calling SE_stream_bind_input_column), or the value was not set at the time of execution.
Returned during the execution of an insert or update operation for a column that was bound by reference (by calling SE_stream_bind_input_column) and the value of the indicator variable was neither IS_NOT_NULL_VALUE nor IS_NULL_VALUE.
An invalid or NULL SE_CONNECT connection handle was passed to an ArcSDE function.
An invalid DBA password was passed to an ArcSDE function.
The specified path was not found.
The SDEHOME variable is not set and is needed for this operation.
The user must be the owner of the table.
The specified process ID does not correspond to an ArcSDE server.
The DBMS did not accept the username or password that was passed to an ArcSDE function.
The timestamp of the password received was sent more than MAXTIMEDIFF seconds earlier.
The server machine was not found.
The I/O manager is not started. Log in as the ArcSDE administrator and use the sdemon administration tool to determine the status of the I/O manager.
ArcSDE was unable to locate the appropriate entry in the /etc/services file. See your ArcSDE system administrator.
Tried statistics on a nonnumeric column.
Tried distinct statistics on an invalid type.
Invalid use of the grant/revoke functions.
The supplied SDEHOME path is invalid or NULL.
An invalid stream (SE_STREAM) handle was detected.
An attempt was made to create a stream, but the connection already has the maximum number of streams specified by the giomgr.defs parameter MAXSTREAMS.
Exceeded systems maximum number of mutexes. Involved in concurrency issues.
The connection is locked to a different thread.
This connection is being used currently by another thread.
Returned when trying to describe a prepared SQL statement that was not a query.
A function was called out of sequence. For example, SE_stream_fetch was called before executing the stream with SE_stream_execute.
Returned when trying to set or get the value of a column in a stream using the wrong column type. For example, calling SE_stream_get_integer on a column that is an SE_FLOAT.
The specified point table is locked to a different thread.
The point table is being used at the moment by another thread.
The specified shape table is locked to a different thread.
The shape table is being used at the moment by another thread.
An invalid value is specified in the filter_type field of the SE_FILTER structure.
The shape doesnt have a CAD entity.
No instance is running on the specified server.
The specified instance is a version older than 2.0.
The specified systems units were < 1 or > 2147483647.
The specified units were not feet, meters, decimal_degrees or other.
The SE_CAD pointer is not initialized.
The specified version doesnt exist.
A set of spatial filters is supplied to SE_stream_set_spatial_constraints with an SE_SPATIAL_FIRST search order, but all the filters have their truth set to FALSE. This prevents ArcSDE from using its spatial index.
A stream function is called that is not applicable to the given stream. For example, a call to SE_stream_set_integer on a query_layer stream.
The specified column contained NOT NULL values during SE_layer_create.
SE_stream_get_spatial_masks was called on a query stream with no spatial masks.
The iomgr program was not found.
The specified operation must be run on the server.
Only one spatial column is allowed for this operation.
The given shape object handle is invalid.
The specified shape part number does not exist.
The given shapes are of incompatible types.
The specified part offset is invalid.
The given coordinate reference systems are incompatible.
The specified coordinate exceeds the valid coordinate range.
The maximum number of layers was exceeded in the cache.
The given coordinate reference object handle is invalid.
The coordinate system identifier is invalid.
The coordinate system description is invalid.
The SE_ROW_ID owner.table does not match the specified layer.
An error occurred while projecting the shape.
The value of the max_array_size set in SE_STREAM_SPEC is larger than the MAXARRAYBYTES value in the giomgr.defs file.
Two donuts or two outer shells of a polygon overlap.
The number of points is less than the number required for a shape.
A part separator is in the wrong position.
The polygon does not close properly.
The polygon outer shell does not completely enclose all the donuts in a part of the shape.
The polygon shell has no area.
The area shape contains a vertical line.
The multipart area shape has overlapping parts.
A simple line or polygon boundary intersects itself.
The specified export file is invalid.
Attempted to modify or free a read-only shape from a shape table.
The specified data source (or database) is invalid.
A stream specification parameter exceeds the giomgr.defs default.
An attempt was made to alter a layer in an illegal manner. For example, if a layer allows annotations, you cant change the layer to disallow them.
The specified spatial column name is the same as the table name. Returned by SE_layerinfo_set_spatial_column.
The specified database (or data source) name is invalid. Returned by SE_connection_create.
A required spatial SQL extension isnt present in the underlying DBMS.
Obsolete 3.0.2 error code. The dimension parameters for an Spatial Database Option (SDO) table were not found in the dbtune.sde file. Add the parameters to the ##DEFAULTS or another keywords section before trying to recreate the SDO layer. (Oracle® specific)
Obsolete 3.0.2 error code. The dimension parameters in the SDODIM table for an SDO table were not found or are corrupted. (Oracle specific)
Obsolete 3.0.2 error code. The requested operation is not supported for normalized layers. (Oracle specific)
Obsolete 3.0.2 error code. Returned if an SDO layer is registered in the ArcSDE LAYERS table, but wasn't created by the ArcSDE software. Usually returned when trying to change a layer between normal and loadonly modes. (Oracle specific)
Returned if a user tries to insert or update a value into SE_ROW_ID column.
The current table doesnt have an ArcSDE-maintained rowid column.
The column is maintained by the ArcSDE software and isnt user-modifiable.
Illegal or blank version name.
The specified state is not in the VERSION_STATES table.
The SE_STATEINFO object isnt initialized.
Attempted to change the state of a version, but its already changed.
Tried to open a state which has children.
To create a new state, the parent state must be closed.
The specified version already exists.
Attempted an operation on a table that isn't multiversion.
You cant delete a state thats being used by a version.
The VERSIONINFO object hasnt been initialized.
The state ID is out of range or doesnt exist.
The SDETRACELOC environment variable isnt set.
A problem occurring when loading the server-side application.
This operation has more states than can fit in an SQL statement.
The function takes two different states, but the same one was given twice.
The table doesnt have a usable row ID column.
The state must be set before calling the function.
An error occurred while executing a server-side application function.
The REGINFO object hasnt been initialized.
Attempted to trim between states on different lineage branches.
The specified state is currently being modified.
A lock was requested for a state tree but one or more of the states is already locked.
The raster column has non-NULL values or is being used as a row_id column.
A raster column already exists.
Unique indexes are not allowed on multiversion tables.
Invalid layer storage type.
No SQL type provided when converting a NIL shape to text.
Invalid byte order for well-known binary shape.
The shape type in the given shape is not a valid geometry type.
The number of measures in the shape must be zero or equal to the number of points.
The number of parts in the shape is incorrect for its geometry type.
The memory allocated for a ESRI binary shape is too small.
Shape text representation exceeds the maximum allowed string length.
A syntax error exists in the supplied shape text representation.
Number of parts in the shape is more than expected for the givenshape text representation.
Shape's SQL type is not as expected when constructing the shape from the text representation.
Found a parenthesis mismatch when parsing the shape text representation.
A NIL shape is not allowed in a well-known binary representation.
Tried to start an already running ArcSDE instance.
The requested operation is unsupported.
An invalid request was made on an external layer. Replaced the SE_INVALID_REGISTERED_LAYER_OPTION return code.
The dimension parameters for a normalized layer table were not found.
The query type is invalid.
The library doesnt contain any trace functions.
Tried to start tracing but its already enabled.
Tried to stop tracing but its already disabled.
Shape comparison language statement couldnt be interpreted by the SCL compiler.
The table is already registered.
The registration ID is out of range.
The table is not registered.
The number of registered tables has exceeded the max_registrations value.
The object cant be deleted because other objects depend on it.
The row lock is already enabled.
The row lock is already disabled.
Another user is using the requested raster column.
The specified raster column doesnt exist.
The specified raster column number is out of range or doesnt exist.
The maximum number of raster columns was exceeded.
The specified raster number is out of range.
The status of the request can't be determined.
Can't open the request results.
The specified raster band already exists.
The specified raster band doesnt exist.
The specified raster already exists.
The specified raster doesnt exist.
The maximum allowed number of raster bands was exceeded.
The maximum allowed number of rasters was exceeded.
The specified DBMS view already exists.
The specified DBMS view doesnt exist.
The specified lock record already exists.
A conflict exists in the row locking mask.
The specified raster band is not in a raster.
The specified RASBANDINFO object doesnt exist.
The specified RASCOLINFO object doesnt exist.
The specified RASTERINFO object doesnt exist.
The specified raster band number is out of range or doesnt exist.
Only one raster column is allowed.
The specified table is already locked.
The SE_LOGINFO pointer isnt initialized.
The operation generated a SQL statement that is too long for the internal buffers or the underlying DBMS. Could possibly occur with difference detection or versioned queries.
The operation isnt supported with views.
The specified logfile already exists.
The specified logfile is open.
The specified spatial reference entry already exists.
The specified spatial reference entry doesnt exist.
The specified spatial reference entry is in use by one or more layers.
The SE_SPATIALREFINFO object isnt initialized.
The raster band squence number already exists.
The SE_QUERYINFO object isnt initialized.
The SE_QUERYINFO object hasnt been prepared for a query.
The SE_RASTILEINFO object isnt initialized.
The SE_RASCONSTRAINT object isnt initialized.
The record ID number doesnt exist or is invalid.
The SE_METADATAINFO object isnt initialized.
The meta-data object type isnt supported.
The SDEMETADATA table doesn't exist.
The meta-data record doesnt exist.
The geometry entry doesnt exist.
The file path either doesnt exist, is too long (>512 characters), or contains invalid characters. Returned by SE_connection_create when checking SDEHOME or a path to a database.
The locator object is not initialized.
The table doesn't have an associated locator.
The locator is not valid.
The locator category isn't specified.
The locator name is invalid.
The locator doesn't exist.
The locator already exists.
The locator type is unsupported.
The coordinate reference isnt defined.
You cant trim past an already reconciled state.
The fileinfo object doesnt exist.
The fileinfo object already exists.
The fileinfo object isnt initialized.
The fileinfo object type isnt supported.
Statistics arent available for this raster band.
You cant delete a version that has child versions.
SQL type doesnt support annotation or CAD entities at the current release.
The dbtune.sde file is missing or unreadable.
The logfile system tables dont exist or could not be created when the ArcSDE server was started.
This application cant perform the operation on the specified object.
The given geographic transformation object is invalid.
The specified column already exists.
The specified SQL keyword doesnt exist or is invalid.
The specified objectlock handle is invalid.
The raster buffer size is not large enough.
The specified raster data is invalid.
The specified operation is not allowed.
The specified SE_RASATTR object isnt initialized or is invalid.
The specified version ID is invalid.
You cant put a multiversion table into load-only mode or make a load-only table multiversioned.
The user-supplied table or column is invalid.
The next row was not the expected row.
The ArcSDE instance is read-only.
Image mosaicking is not allowed.
The raster bitmap object is invalid.
The specified band sequence number does not exist.
The feature type (i.e., rect, arc, circle) is an invalid SQLTYPE.
DBMS Objects (Spatial, ADT's not supported)
No columns found for binary onversion (LOB/LONGRAW)
The raster band has no colormap.
Invalid raster band bin function.
Invalid raster band statistics.
Invalid raster band colormap.
Invalid raster layer configuration keyword.
This sort of iomgr can't run on this sort of instance.
Export file's volume info is invalid.
Invalid compression type.
Invalid index parameter.
Invalid index type.
Try to set conflicting value in object.
Abstract Data types not supported.
No spatial index.
Name not valid for DBMS.
ROWID for Oracle Spatial table already exists.
gsrvr dll for direct could not be loaded.
The table can not be registered.
Operation not supported on multiversion table.
No ArcSDE server license was found.
Exportfile format is not supported.
Specified table is in use
SE_XMLINDEXINFO object not initialized
Specified XML column exists
Tag's data type or alias doesn't match.
XML index already exists.
Specified XML index does not exist.
Tried to alter non-modifiable field.
Cannot alter/delete template that's referenced by column.
Must be owner to del/alter.
SE_XMLDOC object not initialized
Named tag not found.
Illegal XML document syntax
The ZM column does not exists in the layers table
Invalid date value
Given XML column not found
Both XML columns must be the same for this operation.
Incorrect xpath syntax.
Input xpath tag not supported in current release.
SE_COLUMNINFO object not initialized
SE_XMLTAGINFO object not initialized
Wrong type of XML index
The requested operation is unsupported by instance db.
Incorrect xpath location alias syntax.
Incorrect xpath predicate token.
Incorrect xpath predicate operator.
Incorrect xpath predicate contain function syntax.
Empty xpath element is not allowed.
Incorrect xpath token.
Environment var SDETMP not set to a value
SERVERINFO object not initialized.
Ambiguity between a user name and group name when working with permissions
Geocoding rule file already exists and force_overwrite is not specified
Geocoding rule file is not found
Geocoding rule is not found in geocoding rule table
Geocoding rule already exist in the geocoding rule table and force_overwrite is not specified
SE_XMLCOLUMNINFO object not initialized
Invalid system group name
Column contains NOT NULL values during SE_xmlcolumn_create()
Locator property is too long or invalid
Locator property has multiple values
Search window completely outside oracle spatial geodetic extent
Cannot use xpath searches on non-indexed columns.
The current table doesn't have SDE-maintained UUID column.
Invalid UUID column.
Underlying RDBMS doesn't support 64-bit layer.
Invalid (rebuild) index mask
Coordref/Layer precision not OK for requested operation.
The SE_TRANSFORMINFO object is not initialized
Invalid raster band transform list
The raster band has no transform list
SE_QUERYCOLUMN object not initialized
Multiple shapes set to SE_SHAPESOURCE shape
SE_QUERYSELECT object not initialized
SE_SHAPESOURCE object not initialized
SE_SPATIALCONSTRAINT object not init'ized
QUERYFROM join constraint missing
QUERYFROM join conflict
QUERYFROM join table missing
SE_QUERYTABLE object not initialized
SE_QUERYFROM object not initialized
SE_XMLCONSTRAINT object not initialized
SE_ATTRIBUTECONSTRAINT object not init'ized
SE_QUERYWHERE object not initialized
Error opening codepage converter
The destination string buffer is too small
Codepage conversion error
Operation invalid on a closed state.
The requested operation is invalid on the base state.
The direct connect is not registered with an ArcSde server for license.
The given range of ids is invalid
This state object doesn't contain lineage info.
OGCWKB type does not support ANNO or CAD.
Not allowed to set image origin.
Not a valid image origin.
The raster band has no GDB metadata.
Invalid raster band GDB metadata.
Not allowed to create index complex column
Can't start compress if compress is already running
Schema is out of date.
Has rows in delta tables.
Lost connection to underlying DBMS
Overflow or value larger then a 32bit integer
DBTUNEPARAM object not initialized
DBTUNEKEYWORD object not initialized
Table is already archiving
Archiving not enabled on this table
XMLCOLUMN alter tried to modify a column property that cannot change
The supplied project instance handle is bad
The schema already exists
User has no permissions to create tables in this schema
The Layer is already registered outside the current schema
The Table is already registered outside the current schema
Operation is only valid if there is a user transaction
Datsource machine was not found
The column index is being altered
Lost connection to underlying DBMS
The XML column is in Load-only mode
The XML column is in Normal mode
The Table is in Load-only mode
Can't set archiving flag during create/alter registration
Invalid DBTUNE data
The keyset table could not be created
The keyset table could not be removed
Operation not allowed on a history table
ST_GEOMETRY type not installed
Invalid connection property
The Object being referenced is not initialized
General raster compression error
SE_ARCHIVEINFO object not initialized
DBMS constaint does not exist
DBMS constraint exists
SE_LAYERGRID pointer not init
INSERT, UPDATE, and DELETE access must be revoked first
Keyset table not created for query
Invalid raster column name
This operation not supported with a keyset table.
The following codes are returned when a non-fatal exception occurs.
Returned by functions that completed successfully but made changes of which the caller needs to be aware. This return code should not be considered a fatal error by the application program.
The function completed successfully but it changed the entity type of the shape.
No rows were deleted.
The user tried to perform an SE_DISTINCT_STATS statistic and the resulting number of distinct values exceeds the maximum number allowed. The maximum allowed is the lesser of MAX_DISTINCT (giomgr.defs) and the max_distinct argument in SE_table_calculate_stats.
Returned by the SE_stream_get_<data_type> functions when the given column has a NULL value in the current row.
Returned during an update operation when no rows satisfied the users where clause.
No codepage conversion.
Cannot find the codepage directory.
The DBMS doesnt support this function.
The DBMS function ID is invalid. Returned by SE_connection_get_dbms_function.
The layer extent couldnt be updated.
No localized error messages are available.
Spatial index not created, server inability to support SPIDX_PARAM specified
SDE does NOT support this function on this DBMS
SQL statement that is being re- executed was not found in the cache
The Object being referenced does not exist
The limit for Max # of ordinates in the SDO_ORDINATES varray has been reached
No cluster tolerance properties persisted in this spatial reference schema
No compress status info available
The following status codes are found in the giomgr.log file when a connection exits.
When a connection goes down on a signal or with an exception code, see your operating system documentation for information on any reported warnings or errors.