Error codes

 

Each NotesToPaper function provides return values. If the return value is negative, then an error has appeared in the function. There is no error if the return value is zero. What a positive return value indicates depends on the particular function. The exact meaning of the error codes can be found in the table below:

 

Note: The constants for the error codes are defined in the NTPDEF.SCR file. Always use these constants in script programming.

 

The explanation of the individual error codes can be found in the following table:

 

Nr.

Constant

Description

Note

0

ERRNTP_None

No error

-

-1

ERRNTP_Unknown

Unknown error

Contact the support

-3

ERRNTP_KeyError

The registration key is invalid

Check the registration key.

-4

ERRNTP_ServerKeyError

The registration key is invalid for a server installation

NotesToPaper is installed on a server, but has not been licensed for a server installation. Contact the support.

-5

ERRNTP_RTFKeyError

The RTF-export could not be called

Contact the support

-6

ERRNTP_BarcodeKeyError

The registration key is not valid for the barcode module

The 2D barcode modules require a special registration key. Please ensure the correct data entry when entering the key. In case of problems, contact our Support.

-10

ERRNTP_MemoryError

Not enough RAM available

Allow the application to access more RAM

-11

ERRNTP_PointerError

Internal program error

Contact the support

-12

ERRNTP_CreateTempFile

Temporary spool file could not be created

Does the temp-directory exist and is it accessible/editable?

Check the NTP-configuration settings.

-13

ERRNTP_NoValidHandle

No valid handle

The handle called is no longer valid (e.g. when calling NTPProcessReportExt)

-14

ERRNTP_HandleDeleted

Handle deleted

Handle has been deleted, e.g. by calling NTPCancel

-15

ERRNTP_FileNotFound

File not found

Directory name correct (e.g. NTP.INI)?

-16

ERRNTP_WriteTempFile

Error writing to the spool file

Is the drive accessible? Is the file editable?

-19

ERRNTP_DataFileNotFound

Spool file not found

Was the spool file deleted? Is the temp directory still available?

-21

ERRNTP_ININotFound

INI-file not found

 

NTP.INI not found in the Windows- or Notes-directories

-22

ERRNTP_ReportPathNotFound

Path to the report files not found

Report path in NTP.INI is incorrect

-23

ERRNTP_ReportDefNotFound

Report definition not found

No report definition found in the NTP.INI path

-24

ERRNTP_NoFields

No field error in the report definition

Fields have not been defined in this report definition. Use NotesToPaper Setup to create at least one field.

-25

ERRNTP_UnknownReportType

Unknown report type

The report type in the report definition is invalid

-26

ERRNTP_OpenErrorDataFile

Error opening the spool file

Is the drive accessible? Is the file editable?

-27

ERRNTP_ReadErrorDataFile

Error reading from the spool file

Is the drive accessible? Is the file editable?

-28

ERRNTP_NoData

No data in spool file

No data found in the spool file. You have to pass at least one data set by script (NTPSendField)

-30

ERRNTP_NoReportSelected

No report file selected

No report definition selected, e.g. when calling NTPReportList

-33

ERRNTP_NoValidOption

An invalid parameter was used calling NTPSetOption

Check the script call and the possible parameters

-34

ERRNTP_PreviewFileNotFound

Sending the report is not possible, the preview file was not found.

The preview file could not be accessed or may have already been deleted (e.g. when using NTPExportReport)

-35

ERRNTP_PreviewFunctionNotInstalled

This NotesToPaper-function is not installed

Probably incomplete installation of NotesToPaper (e.g. the integrated Mail-Client was not installed)

-36

ERRNTP_PreviewFunctionNotFound

Function not found in the DLL

Possibly a wrong or damaged version of the DLL

-37

ERRNTP_EndOfFieldsReached

The attempt was made to pass a further field value (e.g. NTPSendField), but no further fields are available

Check the number of NTPSendField calls in relation to the defined fields.

-38

ERRNTP_VariableNotFound

The variable name could not be found (e.g. NTPSendVariable)

Check the spelling of the variable name in the command and in the definition

-39

ERRNTP_NoLanguageFileFound

No language file found

Check if all language files are available

-40

ERRNTP_ReadErrorReadingTableNames

The table names could not be read in the report layout

Does the report layout exist? Is the directory accessible? Do tables exist in the report layout?

-41

ERRNTP_NoValidRecordNumber

Internal error saving the data set

Contact the support

-42

ERRNTP_UnknownFieldType

Unknown field type in the report definition

Possibly an error in the report definition. Open the report in NotesToPaper Setup, change the fields and save the report again.

-43

ERRNTP_UnknownVariableType

Unknown variable type in the report definition

Possibly an error in the report definition. Open the report in NotesToPaper Setup, change the variables and save the report again.

-44

ERRNTP_UnableToCopyPreviewFile

The preview file created cannot be copied

Temp directory accessible/editable? Check the NTP-configuration settings.

-45

ERRNTP_UnableToCopyLayoutFile

The report layout files could not be extracted to the temp directory.

Temp directory accessible/editable? Check the NTP-configuration settings.

-46

ERRNTP_InvalidLanguageNumber

Language number is invalid

Check the NTPSetLangauge parameters. What language packs have been installed?

-47

ERRNTP_LanguageNotSupported

The language passed is not installed.

Do you have a language file installed, that supports the desired language?

-48

ERRNTP_UnknownFieldName

Unknown field name

The field name used when calling e.g. NTPSendFieldByName does not exist. Check the command or the defined fields.

-49

ERRNTP_NoFieldNameSpecified

No field name specified.

When using e.g. NTPSendFieldByName no field name was specified.

-50

ERRNTP_InvalidAppendToHandle

The handle used for NTPProcessReportAndAppend is invalid

Check the handles used with the command possibly one of the handles is invalid.

-100

ERRNTP_FunctionNotFound

A function was not found in a DLL

Ensure the DLL belongs to NotesToPaper and is available in the correct version.

If in doubt, contact the support.

-106

ERRNTP_OpenDatabase

The database could not be opened

1.) The database named does not exist. Check server and database name in the script.

 

2.) The database should be located on a server otherwise access conflicts are possible. It is possible another application has already accessed the same database.

-107

ERRNTP_DocumentNotFound

The document could not be found

Did you send the correct document ID in the script? Check the script-programming.

-109

ERRNTP_ExportError

Error exporting the document

An error occurred while exporting a Notes field. The error was caused by the Notes API.

Check the usage of the NTPSendRT... command. Contact the support

-110

ERRNTP_UNIDToShort

The UNID does not have the correct length of 32

Check the command and the UNID passed. Further information can be found at RTF Export.

-120

ERRNTP_DLLLoadError

A DLL could not be loaded

Are all additional DLL's available?

Ensure the DLL belongs to NotesToPaper and is available in the correct version.

If in doubt, contact the support.

-121

ERRNTP_UnknownExportFormat

The defined export format is invalid

You have defined an export-format that is invalid or you are accessing an export format where the export library is not installed.

-122

ERRNTP_InvalidFieldNumber

A field with this number does not exist.

Check the parameter of the function. A non-existing field number was specified.

-123

ERRNTP_ReturnBufferToSmall

Buffer for the return value is too small

The return value of a function does not fit in the buffer. Increase the buffer for the function.

-124

ERRNTP_NotAllowedOnServer

Function cannot be executed on a server

A function/option was used which is not permissible/possible on a server. Change the programming.

-125

ERRNTP_NoDefaultPrinterDefined

No default printer installed

A report is being executed on a machine which does not have a printer installed. Install a printer. This is an error which is frequently encountered on a server.

-126

ERRNTP_ReportNotReleased

Report is not released

The report has not been released. In NotesToPaper Setup. Release the report by using NotesToPaper  Setup.

-127

ERRNTP_InvalidSumVariableFormat

The format to define a sum variable is incorrect

The attempt has been made to set a default value for a sum variable. A wrong name or format was used. Check the programming.

-128

ERRNTP_UnableToGetLanguageID

Language set could not be detected

NotesToPaper  in anenvironmentwhich is not supported.

-129

ERRNTP_NoValidOptionValue

The value set is invalid for the parameter

You are attempting to set a value for a parameter (e.g. by using NTPSetOption) which is not supported by this parameter.

-130

ERRNTP_InValidFontName

Font name is not valid

You are attempting to use a font name (e.g. for a font-mapping), which cannot be found on the machine. Check the programming.

-131

ERRNTP_UnableToLoadBarcodeModule

The add-on module cannot be found or cannot be loaded

A part of the program NotesToPaper cannot be found or cannot be loaded. Please check the installation and possibly install additional modules/program parts.

-132

ERRNTP_UnableToLoadAddOnModules

The add-on module cannot be found or cannot be loaded

A part of the program NotesToPaper (e.g. the export module) cannot be found/loaded.Please check the installation and possibly install additional modules/program parts.

-403

ERRNTP_NotPrepared

The database is not prepared to work with NotesToPaper

The database does not contain (or contains the wrong) design-elements for NotesToPaper. Use NotesToPaper Setup to prepare the database.

-410

ERRNTP_ReportNotFound

The report name specified could not be found in the database

Check the report name. Is the report available in the database?

Are the NTPInit... correct?

-411

ERRNTP_TempPathNotFound

No temp or invalid temp directory

Check the temp directory settings on the system.

Check the NTP-configuration settings.

-412

ERRNTP_ReportWriteError

The report definition could not be saved in the temp directory

Do you have sufficient access rights to the temp directory? Has the temp directory been correctly set?

Check the NTP-configuration settings.

-413

ERRNTP_LayoutWriteError

The report layout could not be saved in the temp directory

Do you have sufficient access rights to the temp directory? Has the temp directory been correctly set?

Check the NTP-configuration settings.

-500

ERRNTP_UnableToAccessPrinters

Printer not accessible

The printer set in the report cannot be accessed or you are attempting to set a printer that is not accessible/does not exist.

-501

ERRNTP_NoPrintersInstalled

No printers installed on this system

Install at least one printer on the system

-502

ERRNTP_InvalidPrinterNumber

The n-th printer is not available

You are trying to access the n-th printer whereby the number is higher than the number of printers installed on this system.

-503

ERRNTP_UnableToFindPrinter

The printer accessed does not exist

You are attempting to access a printer that is unavailable. Check the printer name and the printers availability.

-504

ERRNTP_UnableToGetDefaultPrinter

The standard printer could not be determined

A Windows standard printer could not be determined. Possible causes: No printer installed or no installed printer set as standard printer.

-600

ERRNTP_UnableToOpenPreviewFile

The preview file cannot be addressed

Either the report has not yet been created or the preview file was deleted (see NTPSetOption settings).

-601

ERRNTP_InvalidPageNumber

The requested page number is not accessible in the preview file

Check the command parameters and find the max. page numbers in the preview file.

-602

ERRNTP_UnSupportedGraphicFormat

The requested graphics format is not supported

Check the command parameters.

-603

ERRNTP_UnableToWriteOutputGraphicFile

The export file cannot be created

Check the command parameters. Is the file name for the export correct? Is the directory set valid?

-604

ERRNTP_NoReportPreviewAvailable

No preview file available

After the report creation, the preview file is automatically deleted. In order to access the file ensure this does not happen by using NTPSetOption

-605

ERRNTP_UnableToDrawPage

The report page could not be written to a graphics file

While converting the report page to a graphics file an error occurred. Possible causes, insufficient RAM or insufficient free disk space.

-700

ERRNTP_UnknownAttachmentError

Unknown error when accessing an attachment

Please notify the support

-701

ERRNTP_NoneAttachmentsFound

No attachments found in document

You are attempting to detach an attachment from a Notes rich text field/ document (e.g. by using NTPSendDrawingFieldName), which however does not contain attachments. Check the programming.

-702

ERRNTP_UnableToReadAttachments

Attachment in document cannot be read

The access to an attachment in a Notes document has failed. Check if all parameters are correct and if the access rights are sufficient.

-703

ERRNTP_UnableToFindAttachment

Attachment in document cannot be found

The access to an attachment in a Notes document has failed. A non-existing attachment name was used.

-704

ERRNTP_UnableToDetachImageRes

Access to image resource failed

An image resource in the database cannot be read. Check if the name is correct and if the access rights are sufficient.