Viesus PDF Enhancer - Error Codes

This document provides a comprehensive list of error codes returned by the Viesus PDF Enhancer, organized by category for easier troubleshooting and debugging.

Error Code Categories

Success Code

Code	Error Name	Description
0	eNoFailure	Processing completed successfully with no errors

General System Errors (1-8)

Code	Error Name	Description
1	eErrUnknown	An unknown or unspecified error occurred
2	eErrAlreadyEnhanced	The PDF file has already been enhanced (use force option to re-process)
3	eErrLoadSettingsFile	Failed to load the configuration/settings file
4	eErrOpenDocument	Unable to open the PDF document (file may be corrupted or password-protected)
5	eErrCreateDir	Failed to create required directories
6	eErrInvalidPDF	The input file is not a valid PDF document
7	eErrLicense	License validation failed or license is invalid
8	eErrPdfLib	PDF library initialization or operation failed

File System & Path Errors (9, 12, 14-18)

Code	Error Name	Description
9	eOmitFileSize	File size is below the minimum threshold for processing
12	eErrFileNotFound	The specified input file could not be found
14	eErrPathNotFound	The specified path does not exist
15	eErrViesusSettingsNotFound	VIESUS configuration file not found
16	eErrDestFolderNotFound	Destination folder does not exist or is not accessible
17	eErrArchiveFolderNotFound	Archive folder does not exist or is not accessible
18	eErrDebugFolderNotFound	Debug folder does not exist or is not accessible

File Operations & Permissions (10-11, 21-22, 29)

Code	Error Name	Description
10	eErrSavingFile	Failed to save the processed file
11	eErrReplacingImage	Error occurred while replacing images in the PDF
21	eErrFilePermissions	Insufficient file permissions for the operation
22	eErrFilePermissionsChange	Failed to modify file permissions
29	eErrDeleteFile	Unable to delete the specified file

Configuration & Parameters (19-20)

Code	Error Name	Description
19	eErrCmdLineParameterWrong	Invalid or incorrect command line parameters provided
20	eErrViesusError	General VIESUS processing error

PDF Processing Errors (13, 23-28)

Code	Error Name	Description
13	eErrPdfLibraryInitFailed	PDF library failed to initialize properly
23	eErrPdfFlattening	Error during PDF flattening process
24	eErrPdfColConvert	PDF color conversion failed
25	eErrPdfFlatteningInit	PDF flattening initialization failed
26	eErrViesusEnhancement	Image enhancement process failed
27	eErrReadingImageLocation	Failed to read image location data from PDF
28	eErrNoPDFforTOXFile	No corresponding PDF found for TOX file

Trigger & Workflow Management (30-35)

Code	Error Name	Description
30	eErrRenameTrigger	Failed to rename the trigger file
31	eErrCopyFolder	Error occurred while copying folders
32	eErrDeleteTrigger	Failed to delete the trigger file
33	eErrRenameFolder	Unable to rename the specified folder
34	eErrCreateTrigger	Failed to create the trigger file
35	eErrArchive	Error during file archiving process

License & Resource Limits (36)

Code	Error Name	Description
36	eErrLicenseExhausted	Processing limit has been reached for the current license

Cropping & Region Processing (37-39)

Code	Error Name	Description
37	eErrWrongCroppingRect	Invalid cropping rectangle specified
38	eErrCroppingRectOutofPage	Cropping rectangle extends beyond page boundaries
39	eErrDuringCropping	Error occurred during the cropping operation

Troubleshooting Tips

Common Solutions by Error Category

File System Issues (Codes 12, 14-18)

• Verify all file and folder paths exist
• Check read/write permissions
• Ensure sufficient disk space

Permission Errors (Codes 21-22)

• Run with appropriate user privileges
• Check file/folder permissions
• Ensure exclusive access to files

PDF Processing Issues (Codes 6, 13, 23-28)

• Verify PDF file integrity
• Check for password protection
• Ensure PDF version compatibility

License Issues (Codes 7, 36)

• Verify license validity and expiration
• Check processing limits
• Contact support for license issues

Configuration Errors (Codes 3, 15, 19)

• Validate configuration file syntax
• Check parameter values and ranges
• Verify file paths in configuration

Error Handling Best Practices

1. Log Error Codes: Always capture and log the specific error code for debugging
2. Check Prerequisites: Verify file permissions, paths, and license status before processing
3. Validate Input: Ensure PDF files are valid and accessible
4. Monitor Resources: Check available disk space and memory
5. Backup Originals: Use archiving to preserve original files before processing