Quick Reference to Commonly Seen Error Codes
Estimated Reading Time: 5 MinutesReturned exceptions are documented in the Adobe PDF Library header file AcroErr.h
, but some are seen more than others, and this table provides more information on some of the more common ones, and their likely causes. Each can be quickly broken down into three components after first converting the returned value from Decimal to Hexadecimal (if required).
The hexadecimal value can be visually separated into its three component fields: Severity, System and Error:
Severity
Four returned values are defined (plus zero, if you want to count that, indicating that No Error Occurred):
- ErrWarning: Warning only
- ErrSuppressable: Error, but only displayed if the user has not suppressed errors
- ErrSilent: Error, but never displayed
- ErrAlways: Typically the worst error to return, and is shown always, regardless of user's suppression setting
Note: Oddly, comments in the AcroErr.h file only list values 1, 2 and 4 above (None, Warning and Severe respectively), with no mention of 3 (ErrSilent) at all.
System
This value here is further defined by the specific Error within this group that will be returned. (Technically, a zero value represents ErrSysNone, when no error occurred.)
-
ErrSysCos: CosStore, filters errors
-
ErrSysCosSyntax: Cos syntax errors
-
ErrSysPDDoc: PDDoc and family, Page tree, outlines errors
-
ErrSysPDPage: PDPage and family, thumbs, annotations errors
-
ErrSysPDModel: Global PD errors
-
ErrSysAcroView: AcroView errors
-
ErrSysPage: Page parsing and RIPping errors
-
ErrSysFontSvr: Font Server errors
-
ErrSysRaster: Rasterizer errors
-
ErrSysASFile: ASFile I/O errors
-
ErrSysXtnMgr: Extension Manager errors
-
ErrSysXtn: New error codes added by extensions
-
ErrSysMDSystem: Platform-specific system errors
-
ErrSysMDApp: Platform-specific application errors
-
ErrSysPDFX: PDFX-specific errors
-
ErrSysPDFEdit: PDFEdit errors
-
ErrSysPDSEdit: PDSEdit (structure) errors
-
ErrSysPDMetadata: XAP Metadata errors
Error
This is the level from which a specific return error code will be assembled, along with a short message string. There are too many individual errors to itemize here, but AcroErr.h
shows them all.
Commonly Reported Error Codes
Returned Code (Decimal) | Hexadecimal Equivalent (See next 3 columns) | Severity | System | Error |
Possible Cause(s) |
536936462 | 2001000E | ErrSuppressable | ErrSysCos | cosErrExpectedDict | Expected a dict object. |
536936464 |
20010010 | ErrSuppressable | ErrSysCos | cosErrExpectedNumber | A number object was expected. |
537001995 | 2002000B | ErrSuppressable | ErrSysCosSyntax | cosSynErrUnknownTokenType | Unrecognized token type. |
537001998 | 2002000E | ErrSuppressable | ErrSysCosSyntax | cosSynErrUnterminatedString | Unterminated string. |
537002019 | 20020023 | ErrSuppressable | ErrSysCosSyntax | cosSynErrBadObjStream | There is an error in the object stream. |
537067523 | 20030003 | ErrSuppressable | ErrSysPDDoc | pdErrBadRootObj | The root object is missing or invalid. |
537067605 | 20030055 | ErrSuppressable | PDDoc and family | pdErrCMapNotFound |
The encoding (CMap) specified by a font is missing. This may be the single most-commonly-returned exception, reported when the Library is attempting (unsuccessfully) to locate the Character Map (CMap) file specified by a document font. The root cause of the problem may be that the CMap is indeed missing, but more commonly this arises when the application cannot find its CMap folder at all. |
1073807365 | 40010005 | ErrAlways | ErrSysCos | cosErrRebuildFailed | Could not repair file. |
1073938473 | 40030029 | ErrAlways | ErrSysPDDoc | pdErrNoCryptHandler | The security plug-in required by this command is unavailable. |
1074003975 | 40040007 | ErrAlways |
PDPage |
pdPErrUnableToOpenPrinter |
As described in |
1074397190 | 400A0006 | ErrAlways | ErrSysASFile | fileErrIO | A file I/O error has occurred. |