Error codes

Each n2pdf function provides a return value. If this return value is negative, then an error has occurred within the function. If the return value is zero (or greater than zero), then no error has occurred (and the number indicates the return value of the function). What these positive error codes mean depends on the respective function.

This listing below provides you with the error codes and their meanings:

0

No error

No error encountered.

-1

Unknown error

An unspecified error was encountered. Please contact our support with details of the problem (e.g. log files).

-2

Registration key not found

The registration key could not be found in file N2PDF.INI or in the file that was set using N2PDFSetKeyFileName.

-3

Registration key not valid

The registration key in the file N2PDF.INI (see also N2PDFSetKeyFileName) or the key set using N2PDFSetKey is not valid (e.g. incorrect letters, numbers or formatting) or is expired if it is a demo key.

-4

Server registration key not valid

You are using a registration key for a server in a client environment or a client registration key on a server. Please ensure that you are using the correct key (see N2PDFSetKey and N2PDF.INI).

-6

OEM registration key not valid

You are using a registration key for an OEM license and have set either no code or the wrong code using N2PDFSetProductCode. Please ensure that you are using the correct key (see N2PDFSetKey and

N2PDF.INI) and that you have set the OEM code.

-7

Incorrect registration key for the current version

You are using a registration key that is no longer valid for the current version of n2pdf. The two numbers after "N2-" reflect the registration key's version number and must match those of the product version. Please ensure that you are using the correct key (see N2PDFSetKey and N2PDF.INI).

-8

Server registration key cannot be used on a client

You are attempting to use a server registration key on a client. Please switch the registration key (see also N2PDFSetKey and N2PDF.INI).

-10

Memory error

There is insufficient or no memory available for the application.

-11

Internal error

An internal access error has occurred in n2pdf. Please contact our support with details of the problem.

-12

Temp file cannot be created

The directory set in your system environment (environment variable "Temp") no longer exists or you have either no or insufficient access rights. Please check the directory if you set it using N2PDFSetTempPath.

-13

Job ID not valid

You are trying to reference a Job ID (see "Basic Concept" und N2PDFInit) that has not yet been created. You are probably using an ID (variables content) that was not generated through N2PDFInit. The cause can be found in your script-routine logic.

-14

Job ID deleted

You are referencing a Job ID (see "Basic Concept" and N2PDFInit) that is no longer available. An ID is no longer available after you invoke N2PDFProcess. The cause can be found in your script-routine logic.

-15

Objects not initialized

n2pdf has encountered an internal error when creating objects. Please contact our support with details of the problem.

-16

RTF export library not loaded

The library (nsfExpRTF.DLL) for the RTF export of Notes documents or content could not be loaded. Please ensure that this file is available. It is also possible that this file is available in an outdated version (the file version must be at least 1.4.0.105).

-17

External file not found

You have selected a file name that is non existent or the file cannot be accessed. Please recheck your programming or your access to the file.

-18

Unknown file type of the external file

You have selected a file in a format (e.g. by using N2PDFAddFile), that is unknown to n2pdf or unsupported. Please recheck your script programming.

-19

The file cannot be saved in the RTF format

You chose to save the file in the RTF format, but the file cannot be written. Please check if the file name is correct and if the access rights to the file/directory are sufficient. Please recheck your script programming.

-20

The file cannot be saved in the TXT format

See error number -19.

-21

The file cannot be saved in the HTML format

See error number -19.

-33

Option not available

You are using a setting that is unavailable with N2PDFSetOption or N2PDFSetGlobalOption. Please recheck your script programming.

-34

Parameter is false or missing

You have entered an incorrect value while invoking a function (e.g. N2PDFSetOption) or a value was missing when a function was called. Please recheck your script programming.

-50

No printer installed

No printer has been installed. The attachment conversion requires at least one installed printer (driver).

-60

Error writing the PDF file

While trying to create the physical PDF file on the file system, an error has been encountered. Please contact our support along with any additional information (i.e. log-files) you may be able to provide.

-61

No content in the main body of the PDF

The PDF file cannot be created, as the PDF does not have any content. No content was passed with N2PDFAddContent. A PDF file can only be created if there is content for it. Please recheck your script programming.

-80

No more GDI resources

There are no longer enough GDI resources available for this application. When this error code is received, further execution of PDF creation must be terminated.

-106

Database cannot be opened

While invoking a function, e.g. N2PDFAddRTContent, you have defined a database that cannot be opened. Please check the parameter's database and server names and ensure that the database exists and that you have access to it.

-107

Document not found

While invoking a function, e.g. N2PDFAddRTContent, you have defined a document that cannot be found using the universal ID. Please check the parameter's database name, server name and UNID. Ensure that the database and/or the document exist and that you have access to the database and/or the document.

-109

Document or field cannot be exported

The document or field specified, e.g. using N2PDFAddRTContent, cannot be exported. The document or field probably contains content that is not supported by n2pdf. Contact Support if the problem persists.

-110

Universal ID has too few characters

While invoking a function, e.g. N2PDFAddRTContent, you have defined a document that cannot be found using the universal ID, because the universal ID is too short. The universal ID must have exactly 32 characters. Please recheck your parameter in the Script programming.

-111

Directory does not exist

While creating a PDF file using N2PDFProcess you have specified a directory that is not available. Please check your input in script programming.

-112

PDF file is blocked

While creating a PDF file using N2PDFProcess you have specified a file name that is currently blocked. This can occur, for example, when a different application (Acrobat Reader) has opened a file with this name. Please close the other applications and retry.

-113

No PDF file specified

You specified no file name while creating a PDF file using N2PDFProcess.

-114

Cannot create PDF file

You specified a file name that cannot be used while creating a PDF file using N2PDFProcess. This can occur, for example, when the file name's directory does not exist or when the file name has invalid characters. Please check the script programming.

-115

Name of text template not found

You are attempting to use N2PDFSetOption and the option N2PDFOPTION_PARAGRAPH_SELECT to select a text template that does not exist. Please check the information in the command or create a text template with this name prior to invoking the function.

-116

Name of text template already exists

The name you have entered while attempting to use N2PDFSetOption and the option N2PDFOPTION_PARAGRAPH_CREATE to create a text template already exists. Please check the information in the command and ensure that you are not using a name of any predefined text templates.

-117

Tab object not found

n2pdf has encountered an internal error while creating tabs. Please contact our support with details of the problem.

-118

Paragraph object not found

n2pdf has encountered an internal error while creating text templates. Please contact our support with details of the problem.

-200

The DLL for the PDF SDK cannot be loaded

The library (n2pdfSDK.DLL) to edit PDF files is either not available or could not be loaded. Please ensure the file is actually available.

-202

The attachment could not be detached from the document

The file attachment named could not be detached from the document to be processed. Please recheck the access rights for the document in question or if the document is damaged respectively the file attachment cannot be found in the document.

-203

$FILE not available in the Notes document

You have selected a document, from which an attachment is to be detached, which does not contain a $FILE field. n2pdf can only access attachments in documents that contain a $FILE field.

-204 / -205

$FILE cannot be read

While attempting to access the $FILE field of the Notes document, a Notes API error has been encountered. Please check whether the document is damaged and contact Support with your problem if you cannot find a solution.

-206

The attachment could not be found on the file system

An attachment was detached, however not correctly created on the file system. The file was possibly removed by another application. Please ensure, that the directory for temporary files is correct and you have sufficient access rights.

-207

PDF file cannot be renamed

The attempt was made to add additional PDF files (attachments from Notes documents) to a new PDF file. The PDF file could not be renamed, as it was possibly locked by another application or the file access has been limited. Please check, if the directory for the temporary files is correct and the appropriate access rights have been set.

-208

PDF file cannot be loaded

In order to be able to change PDF settings, the PDF file must be loaded. The file could however not be loaded successfully. Please recheck if the file is locked by another application or if the document is damaged. Please ensure, that the directory for temporary files is correct and you have sufficient access rights. Please contact our support if you cannot find a solution.

-251

Attachment cannot be loaded

n2pdf cannot load the file attachment. The attachments file format is either one that is unknown to n2pdf (thus n2pdf cannot process it) or the file contains information n2pdf cannot process (unsupported content in a supported format). n2pdf cannot process the file.

-252

Attachment cannot be converted

n2pdf can load the file attachment, cannot however convert the attachment. The file contains information n2pdf cannot process (unsupported content in a supported format). n2pdf cannot process the file.

-253

Not a unique file name for the attachment

In order to process a file attachment, the attachment is saved as a temporary file on the file system. This requires a unique file name. n2pdf cannot set a unique file name. The possible cause may be a temp directory that contains to many files.

-254

Attachment cannot be converted (not a supported file format)

An attachment with N2PDFAddAttachment function was transferred but this file format cannot be processed.

-704

Image resource cannot be saved

You are attempting to set a watermark using N2PDFSetOption and the option N2PDFOPTION_PDF_WATERMARK_IMAGE_RESOURCE, however the image resource cannot be detached from the database. The reason is that you have either not specified or incorrectly specified the database, or you do not have access to the database. Please keep in mind that at this time only JPEG image resources can be supported. Please check the call in script programming.

-705

Image resource not found

You are attempting to set a watermark using N2PDFSetOption and the option N2PDFOPTION_PDF_WATERMARK_IMAGE_RESOURCE, however, the image resource cannot be found in the database specified. Please check the information about the database and the name of the image resource. Please keep in mind that at this time only JPEG image resources can be supported. Please check the call in script programming.

-706

Invalid file format for image resource

You are attempting to set a watermark using N2PDFSetOption and the option N2PDFOPTION_PDF_WATERMARK_IMAGE_RESOURCE, however the images have an invalid file format. Only images in JPEG format can be supported at the current time. Please check the call in script programming and the format of the graphics or image.

-707

The image resource file was not found on the file system

An image resource was detached from the Notes database, but the file was not correctly created on the file system. The file was possibly removed by another application. Please ensure, that the directory for temporary files is correct and you have sufficient access rights.

-800

Unknown "search & replace" mode

You have called a mode for the function N2PDFSearchAndReplace that is unknown. Please recheck your parameter in the Script programming.

-801

Unknown characters in the search form

You have defined a search form for N2PDFSearchAndReplace which contains illegal characters. Please recheck your parameter in the Script programming.

-900

No data records for mail merge

You are attempting to use N2PDFSetOption and the option N2PDFOPTION_MAIL_MERGE_MODE to activate a mail merge, but have not defined any data records. Please invoke the function N2PDFAddField with the option N2PDFVALUE_MAIL_MERGE_NEW_RECORD at least one time.

The following error messages may be encountered when processing compressed files

-1000

Not a valid file name

The file name set via the function N2PDFSetOption and the option N2PDFOPTION_COMPRESS_OUTPUT_FILE is invalid.

-1001/-1002/-1003

No archive file/Archive type not supported/Unknown archive type

The archive file could not be unpacked. The file is either not a valid file type, not a supported format or an unknown type of archive.

-1004

Directory to which the archive is to be unpacked is invalid

An error was encountered when unpacking the archive. The path to the operating system temp files does not exist, is invalid or cannot be used. Recheck the path for the temp. files and if the access rights are sufficient.

-1100

File cannot be compressed

The PDF file cannot be unpacked, an internal error was encountered. Please contact our support with details of the problem.

-1101/-1102

Not a valid archive file/file cannot be added to an archive

You are attempting to add a created PDF to an existing archive. The file is either not a valid file type, not a supported format or an unknown type of archive. N2PDFSetOption with the option N2PDFOPTION_COMPRESS_OUTPUT_FILE).

The following error messages may be encountered when using the interface to the "StarOffice Server PDF Converter".

-7001/-7009

Unknown error

An unspecified error was encountered. Please contact our support with details of the problem (e.g. log files).

-7002/-7003/-7008

SOAP message could not be created

The SOAP message needed to communicate with the WebService could not be created. Please contact our support with details of the problem (e.g. log files).

-7004

Unsupported file format

The file format to be converted is not supported by the converter. The conversion is not possible.

-7005/-7006

Server error/error while converting

An error was encountered while converting a file on the server. The cause is either an internal server error or a problem with a file (or the contents of a file). Please retry the conversion. If the problem continues, please contact our support with details of the problem (i.e. log files).

-7007

PDF file could not be saved

A file was created by the converter but the file could not be saved temporarily on the local machine. The path to the operating system temp files does not exist, is invalid or cannot be used. Recheck the path for the temp. files and if the access rights are sufficient.

-7010/-7011

Source file does not exist/source file is locked

A file is to be converted which either does not exist locally or is locked by another application. Please recheck your script programming for logical errors.

-7013/-7014/-7015

SOAP/HTTP connection error

The WebService for the conversion cannot be contacted. Please check your IP address and port settings. Ensure, that the WebService is active on the server and that you have a connection from your client/server to the WebService.