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 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).

-9

The registration key has expired

-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.

-22, -23

The PDF file cannot be written

An error occurred while the PDF was being written. Please contact Support.

-24

The function used is not available because the DLL required could not be loaded.

Please check to be sure the installation was carried out completely. If you are unable to ascertain an error in this regard, please contact Support.

-25

The content cannot be written as a DOCX file.

An error occurred while writing the DOCX file. Please contact Support.

-26, -27

Unable to convert the attachment with OfficeBridge

The file can not be converted with the OfficeBridge, please contact the support.

-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.

-35

No characters outside of the ASCII character set may be used in passwords.

-40

Advanced registration key not found

At least "n2pdf Advanced” is required to be able to use webPDF Server.

-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.

-62

Error while writing XMP metadata to the PDF file

Please recheck your parameter in the Script programming. If you are unable to ascertain an error in this regard, please contact Support.

-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.

-119

The name of the template for paragraph formatting contains forbidden characters

You have used characters that are not contained in the ASCII character set.

-120

The web service answer could not be read

The XML protocol or the PDF file could not be read. Please contact Support.

-121

The table width exceeds the set page format

You can adapt the table (options) to the page width, or select a different mode for Handling tables as an alternative.

-122

Unable to export document (DXL export)

The specified XML document (DXL) could not be exported. Please contact the support.

-123, -124, -125, -126

Unable to calculate Notes formula

The specified document contains Notes formulas that can not be calculated. Please contact the support.

-127

Unable to save XML to file

The XML document could not be written during the DXL export. Please contact the support.

-150

The document cannot be decrypted

An entire document is being exported and either the entire document or parts of it are encrypted and cannot be decrypted with the current ID (which is performing the export). Therefore, this is to be understood primarily as a notice; the rest of the document will still be exported. Only the encrypted contents will be missing from the export.

-151

The specified field cannot be decrypted

The field (item) cannot be exported because it is encrypted and the ID (which is performing the export) cannot decrypt the content. No content for the field will be returned.

-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.

-209

Error while combining: The master PDF could not be loaded.

An attempt was made to append a new PDF file to the master PDF file. The master PDF file could not be loaded because it is probably locked by another application or access to the file is restricted. Please check whether the directory for the temporary files is correct and the appropriate access rights have been set.

-210

Error while combining: The PDF file could not be appended.

An attempt was made to append a new PDF file to the master PDF file. The new PDF file could not be appended because it is probably locked by another application or access to the file is restricted. Please check whether the directory for the temporary files is correct and the appropriate access rights have been set.

-211

Error while combining: The overall PDF file created could not be saved.

An attempt was made to save the overall PDF file. However, the PDF file could not be written to the target directory. Please check whether the directory for the temporary files and the target directory are correct and the appropriate access rights have been set.

-212

PDF Portfolio file cannot be added (format is not supported)

An attempt was made to add a PDF Portfolio file to the content. A PDF Portfolio file cannot be added to the PDF file as content (Convert mode). Please use the Embed mode for this purpose.

-213

The PDF document in the XFA format cannot be added (format is not supported)

An attempt was made to add a PDF document in the XFA format to the content. The XFA format is not supported and the file cannot be added to the PDF file as content (Convert mode). Please use the Embed mode for this purpose.

-214

The outline of a PDF attachment could not be modified

Please recheck your parameter in the Script programming. If you are unable to ascertain an error in this regard, please contact Support.

-215

Error while unpacking an OLE object

This message indicates that the Notes document has structural errors. If you are unable to ascertain an error in this regard, please contact Support.

-216

The unpacked OLE object could not be read as an OLE storage

This message indicates that the Notes document has structural errors. If you are unable to ascertain an error in this regard, please contact Support.

-217

An OLE file format is not supported by n2pdf.

Please check the OLE object. If you are unable to ascertain an error in this regard, please contact Support.

-218

The OLE file format is unknown

Please check the OLE object. If you are unable to ascertain an error in this regard, please contact Support.

-219

The OLE storage file could not be opened

Please contact Support.

-220

The OLE storage could not be created

Please contact Support.

-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.

-255

The format of the attachment will be ignored because it is on the “black list”

The attachment will be ignored by the attachment converter because the format has been placed on the “black list” and therefore cannot be converted.

-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 "OfficeBridge".

-1201/-1202/-1203/-1204/-1205/-1206/-1207/-1208/-1209

Unable to convert the attachment with OfficeBridge

The file could not be converted with the OfficeBridge. Please contact the support with the corresponding information (e.g. log files).

The following error messages may be encountered when using the interface to the "webPDF Server".

-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/-7023

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.

-7024

The web service URL could not be found on the server

A conversion is not possible because the web service to be used could not be found. Please check the settings of your webPDF Server.

-7025

Barcode type not found

A conversion is not possible because the barcode type to be used could not be found. Please check the settings.

-7026

Barcode shape type not found

A conversion is not possible because the barcode form to be used could not be found. Please check the settings.

-7027

Invalid Barcode Compression Mode

A conversion is not possible because the barcode compression mode to be used could not be found. Please check the settings.

-7028

Invalid value for Error Correction of QR Code

Conversion is not possible because the value used for error correction is invalid. Please check the settings.

-7029

Invalid value for Double data type

Conversion is not possible because the value passed in is not a numeric value. Please check the settings.

-7030

Unable to process PDF document with the Barcode webservice

An error has occurred which can not be specified. Please contact the support with the corresponding information (e.g. log files).