ArcObjects error codes

HRESULT Error Codes

When programming with ArcObjects in Java, you are making calls to COM components, and therefore receiving errors from COM components. All COM methods return an unsigned integer called an HRESULT. The HRESULT is essentially a structure that tells whether the method succeeded or failed, and contains additional detailed information about the outcome of the operation. HRESULT values are often used to return error information, but are not specifically considered error codes. When the underlying ArcObjects component returns an error condition as a HRESULT, the Java Interop wraps it in an instance of AutomationException. This AutomationException can be handled by using a Try, Catch, Finally block.

Most HRESULT error constants for ArcObjects libraries are documented in the table below

HRESULTs that are not specific to ArcObjects can be found on MSDN. For a listing of common MSDN HRESULT values, see http://msdn2.microsoft.com/en-us/library/aa378137.aspx.

Locating the HRESULT

The majority of the ESRI ArcObject's error code enumerations are in the 10-digit decimal format. However, three ArcObjects libraries utilize a 3-digit decimal value in the documentation instead of the 10-digit decimal value. These libraries are Geometry (esriGeometryError and esriSpatialReferenceError enumerations), Geodatabase (esriDataConverterError enumeration), and Editor (esriEditorError enumeration). 

AutomationException returns the HRESULT in either 8-digit hexadecimal form or 10-digit decimal form.

The stack trace provided by AutomationException returns the HRESULT as a 8-digit

hexadecimal. Use the steps provided below to convert this 8-digit hexadecimal value into a 3-digit/10-digit decimal value to reference the ArcObjects Error Codes.

AutomationException::getCode() returns the same HRESULT as a positive, 10-digit decimal value. This decimal value cannot be readily used to look up the ArcObjects Error Codes. It must be first converted into a 8-digit hexadecimal.  You can then

use the steps provided below to convert this 8-digit hexadecimal value into a 3-digit/10-digit decimal value to reference the ArcObjects Error Codes.

The table below lists all available error enumeration pages as well as the range of HRESULT values each library contains. If a particular library is not listed, there are no specific HRESULT error codes for that library at this time. Instead, you will receive a general COM error.

See Obtaining Decimal numbers from Hexadecimal values below for instructions on converting the 10-digit decimal value you receive to the 3-digit value found in the documentation.

ArcObjects HRESULT Error Codes:

Enumeration	Library	Min Value	Max Value
esriEditorError	Editor	514	514
esriDataConverterError	Geodatabase	513	532
esriGeometryError	Geometry	513	602
esriSpatialReferenceError	Geometry	514	524
cadastralError	Cadastral	-2147221247	-2147220732
dimError	Carto	-2147220991	-2147220989
annoError	Carto	-2147220991	-2147220985
esriRasterLayerError	Carto	-2147217152	-2147217152
esriImageServerError	Carto	-2147216896	-2147216895
esriNETCDFError	DataSourcesNetCDF	-2147217408	-2147217401
esriRasterLoaderError	DataSourcesRaster	-2147217407	-2147217408
esriRasterError	DataSourcesRaster	-2147217408	-2147217370
esriRasterEncoderError	DataSourcesRasterUI	-2147217408	-2147217403
esriRepresentationDrawingError	Display	-2147218431	-2147218425
esriSpatialAnalystError	GeoAnalyst	-2147217408	-2147217248
esriXYEventError	Geodatabase	-2147220991	-2147220983
esriNetworkErrors	Geodatabase	-2147220991	-2147220879
fdoError	Geodatabase	-2147220991	-2147212030
esriTinError	Geodatabase	-2147219456	-2147219388
esriRepresentationError	Geodatabase	-2147218687	-2147218670
esriGeoDataServerError	GeoDatabaseDistributed	-2147208551	-2147208540
esriTerrainError	GeoDatabaseExtensions	-2147205120	-2147219396
esriGeocodingError	Location	-2147220991	-2147220969
esriRouteEventError	Location	-2147220991	-2147220956
esriUtilityNetworkErrors	NetworkAnalysis	-2147220911	-2147220225
esriExportErrorReturnCodes	Output	-2147220735	-2147220719
esriOutputErrorReturnCodes	Output	-2147220686	-2147220670
esriSchematicErrors	Schematic	-2147218943	-2147218923
esriSurveyDatabaseError	SurveyExt	-2147220992	-2147220969
esriSurveyAnalystCtrlsError	SurveyExt	-2147220736	-2147220735
esriSurveyComputationError	SurveyExt	-2147220480	-2147220479
esriSurveyTPSError	SurveyPkgs	-2147220736	-2147220733
esriCoreErrorReturnCodes	System	-2147221247	-2147221243
messageSupportError	System	-2147220991	-2147220967
tascTMSWorkspaceError	TrackingAnalyst	-2147220480	-2147220352
tascGSDCoreError	TrackingAnalyst	-2147219456	-2147219392
tascTemporalLayerError	TrackingAnalyst	-2147219199	-2147219135

Obtaining Decimal numbers from Hexadecimal values

 

Convert 8-digit hexadecimal to 10-digit decimal value

 

 

 

Convert 8-digit hexadecimal to 3-Digit enumeration values

If you have obtained the 8-digit hexadecimal value from the Geometry (esriGeometry and esriSpatialReference), Geodatabase (esriDataConverter), or Editor (esriEditor) libraries, follow these steps to obtain the 3-digit value.