This page describes the error codes that are returned by function execution problems.

This table lists the possible VirtualViewer errors and their descriptions.

Detailed Status/Error Codes

Error Error Code Description
OUT_OF_MEMORY -1

Failed on memory allocation. Problem with a standard memory allocation. Please see Determining Memory Requirements for more information on the the amount of memory required.

FILE_NOT_FOUND -2

Open call failed when trying to decompress an image.

CORRUPTED_FILE -3

File format is bad or unreadable.

BAD_STRING -4

String passed in is null or invalid.

BAD_RETURN -5

Internal DLL problem. Submit a support ticket and attach document you were processing when you received this error.

CANT_CREATE_FILE -6

Fail on saving when attempting to create a new file. On this error check that you have permission to write to that directory and that there is sufficient space available on the storage device.

FORMAT_NOT_ALLOWED -7

Image was not recognized as a format the library can decompress.

NO_BITMAP_FOUND -8

Getobject() call failed to return bitmap header for using DDB functions or may be returned in formats that can contain vector information such as .WPG, .WMF and .PCT if no bitmap information is found.

DISK_FULL -9

Error writing data to the disk. Standard file i/o write failed.

BAD_DISPLAY_AREA -10

Tried to display with negative coordinates or out of range.

PAGE_NOT_FOUND -11

Used for multi-page file format support when attempting to access a page which does not exist. This error code provides information of an empty Word-page which is not converted to an empty page in PDF or TIFF.

DISK_READ_ERROR -12

File format was truncated and tried to read past end of file. Standard read i/o function failed.

BAD_HANDLE -13

Application passed bad image handle. Not a valid VirtualViewer library image handle.

NO_CLIPBOARD_IMAGE -14

Image not found on clipboard.

NO_SCANNER_FOUND -15

TWAIN scanner driver not installed or not found (TWAIN.DLL).

ERROR_OPENING_SCANNER -16

Bad scanner driver or driver not configured properly.

CANT_FIND_TWAIN_DLL -17

TWAIN scanner driver not installed or not found (TWAIN.DLL).

USER_CANCEL -18

Cancel out of low level save or low level decompress. Usually not an error but termination of a function intentionally.

EVAL_TIMEOUT -19

Date on an evaluation copy of the VirtualViewer product has expired.

USING_RUNTIME -20

Version not allowed for design mode.

PIXEL_DEPTH_UNSUPPORTED -21

Tried to save an image to a format that does not support the image’s bits per pixel. Or tried to per- form an image processing function on an image whose bits per pixel is not allowed. Please see Supported File Formats for the pixel depths of each supported format.

PALETTE_IMAGES_NOT_ALLOWED -22

Some image processing operations does not work on palette images.

NO_LZW_VERSION -23

No LZW or GIF code in this version.

JAR_NOT_FOUND -24

The .jar file containing a class needed to complete the operation was not found. Please carefully examine your CLASSPATH to verify the syntax is correct, and the directory containing the Raster- Master .jar(s) is in the path. For Office 2007-2010 documents, you may need to explicitly specify some jars. If you continue to receive this error, contact Accusoft Support and attach the document you were processing when you received this error.

FORMAT_WILL_NOT_OTFLY -25

Format will not support on the fly decompression.

NO_TCOLOR_FOUND -26

No transparency color information found.

COMPRESSION_NOT_SUPPORTED -27

Currently not supporting this compression format.

NO_MORE_PAGES -28

Returned when scanning has completed all pages in the document feeder.

FEEDER_NOT_READY -29

No more pages ready in document feeder.

NO_DELAY_TIME_FOUND -30

No delay time was found for the animated GIF.

TIFF_TAG_NOT_FOUND -31

Could not find the .TIF tag.

NOT_A_TILED_IMAGE -32

Not recognized as a TIFF tiled image.

NOT_SUPPORTED_IN_THIS_VERSION -33

You are using a version that does not support this function or file format. Contact an Accusoft sales representative if you need this function or format.

AUTOFEED_FAILED -34

Autofeed fail in the TWAIN scanner.

NO_FAST_TWAIN_SUPPORTED -35

TWAIN driver cannot do fast transfer.

NO_PDF_VERSION -36

The PDF processing option was not found. If you have the PDF processing option, please make sure the name of the directory containing VirtualViewer’s pdfplug.dll is in the System environment variable Path.

NO_ABIC_VERSION -37

No ABIC plugin code in this version.

EXCEPTION_ERROR -38

Internal error. An exception occurred during pro- cessing. Please enter a support ticket providing the document that was being processed. If the RasterMaster function being called was not a decompress bitmap, then please include a small sample program that can be used to reproduce the issue. Please see Getting a ClassNotFoundException Error for more information on troubleshooting an exception error.

NO_VECTOR_CAPABILITY -39

No vector plugin found in this version.

NO_PCL_VERSION -40

The PCL processing option was not found. If you have the PCL processing option, please make sure the name of the directory containing VirtualViewer’s pclplug.dll is in the System environment variable Path.

NO_JPEG2000_VERSION -41

No JPEG2000 plugin found in this version.

SEARCH_STRING_NOT_FOUND -42

Did not find attempted search string.

NO_WORD_VERSION -43

The MS Word processing option was not found. If you have the MS Word processing option, please make sure the name of the directory containing VirtualViewer’s docplug.dll is in the System environment variable Path.

PASSWORD_PROTECTED_PDF -44

This file was password protected.

METHOD_NOT_FOUND -45

The VirtualViewer method was not found. Please check the spelling of the method name and VirtualViewer library version.

ACCESS_DENIED -46

Access denied. Please check the security permissions.

BAD_LICENSE_SECONDARY -47

Primary level license loaded is bad.

PASSWORD_PROTECTED_FILE -48

This file was password protected for Word or other formats.

PDF_PACKAGE_NOT_SUPPORTED -49

This PDF file is part of a package that is not supported.

JWEBENGINE_JAR_NOT_IN_CLASSPATH -50

The jwebengine.jar is not in the classpath.

JAVA_1_6_RUNTIME_REQUIRED -51

You must be running java 1.6 or better to use HTML support.

OOXML_LICENSE_NOT_FOUND -52

The OOXML Aspose license file was not found.

OOXML_LICENSE_EXPIRED -53

The OOXML Aspose license file expired or is otherwise invalid.

LICENSE_NOT_FOUND -55

Returned when the SnowboundLicense.jar file is not found.

LICENSE_EXPIRED -56

Returned when the VirtualViewer licenses expires.

LICENSE_ERROR -57

Returned when an error occurs when reading the license.

Note: Older error define values are retrieved from the StatusDetails Property.

General Error Define Values Retrieved from Status Property

Error Error Code Description
GENERAL_STATUS.SYSTEM_CRASH -100

If an internal exception is thrown, this is the resulting value.

GENERAL_STATUS.DELETE_ERROR -101

Image data of the object failed.

GENERAL_STATUS.DEFAULT -102

This is what the internal values are initially set to.

GENERAL_STATUS.SNOWBND_OK 1

Operation completed successfully

GENERAL_STATUS.SNOWBND_ERROR -1

Operation failed. See StatusDetails property.

GENERAL_STATUS.IMAGE_NOT_AVAILABLE -103

Internal image data unavailable when trying to complete an operation.

GENERAL_STATUS.SNOWBND_API_NOT_AVAILABLE -104

API is not implemented

GENERAL_STATUS.NOT_VALID -105

Parameter is not valid.

GENERAL_STATUS.DISPLAY_ERROR -106

General error display.

This table lists other possible VirtualViewer general status/errors codes and their descriptions:

Error Description
DELETE_ERROR

The image in memory cannot be removed.

DISPLAY_ERROR

Any problems with displaying an image will return this error code.

IMAGE_NOT_AVAILABLE

No image data is available to do manipulations on.

NOT_VALID

This is returned if a parameter passed into an API is not valid.

SNOWBND_API_NOT_AVAILABLE

This is returned if an API method is not implemented in the current build.

SNOWBND_ERROR

General API error code of an unsuccessful action.

SNOWBND_OK

General API status of a successful action.

SYSTEM_CRASH

This is returned when a Critical Exception is thrown.