Last Modified October 1, 2026

DNA_Error() API

DNA_Error(Error_No)

DNA_Error(Error_No, value, sizeOfValue)

DNA_Error(Error_No) : JAVA, VB.NET, C#.NET
Parameters	Description
<Error_No>	The Error No from one of the API calls
DNA_Error(Error_No, value, sizeOfValue) : Pascal, VBasic, C, C++, ObjectiveC
Parameters	Description
<Error_No>	The Error No from one of the API Calls.
<value>	Buffer or pointer to Buffer that will hold the short description of the <Error_No>
<sizeOfValue>	Size of the buffer that will hold the short description of the <Error_No>. Recommended size is 2,048 bytes.

DNA_Error will return a short description of the error <error_No> that you can use to inform your User of the error that occured during the Activation Process.

You can also use your own descriptions if required.

The default language used in the short description is "English". You can change the language used in the short description by issuing the DNA_SetLanguage APi Call before calling the DNA_Error API Call.

<Error_No>	<Name>	Short Description
0	ERR_NO_ERROR	`<BLANK>`
-1	ERR_VALIDATION_WARNING	MUST VALIDATE BEFORE `<VALIDATION_LIMIT_DATE>` If you want to retrieve only the "DATE/TIME" and construct your own error text, use `DNA_PARAM("LAST_RESULT_VALUE")` when `ERR_VALIDATION_WARNING` is received. (See also Notes on ERR_VALIDATION_WARNING below)
-2	ERR_DNA_DISABLE	DNA_DISABLE
-3	ERR_ACTIVATIONS_EXCEEDED	THE NUMBER OF PERMITTED ACTIVATIONS HAS BEEN EXCEEDED. THIS ACTIVATION HAS BEEN ALLOWED BUT OTHER INSTALLATIONS MAY NEED TO BE RE-ACTIVATED
1	ERR_NO_CONNECTION	NO CONNECTION
2	ERR_CONNECTION_LOST	CONNECTION LOST
3	ERR_LOCKOUT	LOCKOUT UNTIL `<LOCKOUT_DATE/TIME>` If you want to retrieve only the "DATE/TIME" and construct your own error text, use `DNA_PARAM("LAST_RESULT_VALUE")` when `ERR_LOCKOUT` is received.
4	ERR_INVALID_CDM	INVALID CDM
5	ERR_INVALID_PRODUCT_KEY	INVALID PRODUCT KEY (This is typically a programming logic error and not displayed to the User)
6	ERR_INVALID_ACTIVATION_CODE	INVALID ACTIVATION CODE (This is typically a programming logic error and not displayed to the User)
7	ERR_INVALID_PASSWORD	INVALID PASSWORD (This is typically a programming logic error and not displayed to the User)
8	ERR_ACTIVATION_EXPECTED	ACTIVATION EXPECTED (This is a result of the DNA_Query() API Call, not an error, and not displayed to the User)
9	ERR_REACTIVATION_EXPECTED	REACTIVATION EXPECTED (This is a result of the DNA_Query() API Call, not an error, and not displayed to the User)
10	ERR_BANNED_ACTIVATION_CODE	BANNED ACTIVATION CODE
11	ERR_NO_EMAIL_PROVIDED	NO EMAIL PROVIDED (This is typically a programming logic error and not displayed to the User)
12	ERR_INVALID_BUILD_NO	INVALID BUILD NUMBER (This is typically a programming logic error and not displayed to the User)
13	ERR_EVAL_CODE_ALREADY_SENT	EVALUATION CODE ALREADY SENT
14	ERR_EVAL_CODE_UNAVAILABLE	EVALUATION CODE UNAVAILABLE
15	ERR_CDM_HAS_EXPIRED	CDM HAS EXPIRED (See Notes on ERR_CDM_HAS_EXPIRED below)
16	ERR_CODE_HAS_EXPIRED	ACTIVATION CODE HAS EXPIRED (See Notes on ERR_CODE_HAS_EXPIRED below)
17	ERR_INVALID_NEW_PASSWORD	THE NEW PASSWORD HAS ALREADY BEEN USED. PLEASE PROVIDE A NEW AND NEVER USED PASSWORD TO RE-ACTIVATE
18	ERR_CDM_WRITE_PROTECTED	THE DIRECTORY OR FILE FOR STORING THE LICENSE FILE (CDM) IS WRITE-PROTECTED. PLEASE ENSURE THAT YOU HAVE READ-WRITE PERMISSIONS FOR THIS DIRECTORY OR FILE AND TRY AGAIN
19	ERR_ACTIVATION_EXPECTED_MU	ACTIVATION EXPECTED (This is a result of the DNA_Query() API Call, not an error, and not displayed to the User)
20	ERR_REACTIVATION_EXPECTED_MU	REACTIVATION EXPECTED (This is a result of the DNA_Query() API Call, not an error, and not displayed to the User)
21	ERR_ACTIVATIONS_EXCEEDED_MU	The number of activations has been exceeded for this Activation Code
98	ERR_CANCELLED_BY_USER	CANCELLED BY USER
99	ERR_OPERATION_FAILED	OPERATION FAILED

Declarations and Examples

                	
						FUNCTION DNA_ERROR(ERROR_NO:INTEGER; MSG:PANSICHAR; MSG_SIZE:INTEGER):INTEGER; STDCALL;

                	
						PUBLIC FUNCTION DNA_ERROR(BYVAL ERROR_NO AS INTEGER, BYREF MSG AS STRING, BYVAL MSG_SIZE AS INTEGER) AS INTEGER

                	
						INT __STDCALL DNA_ERROR(INT ERROR_NO,CHAR *MSG,INT MSG_SIZE);

                	
						INT __STDCALL DNA_ERROR(INT ERROR_NO,CHAR *MSG,INT MSG_SIZE);

                	
						INT __STDCALL DNA_ERROR(INT ERROR_NO,CHAR *MSG,INT MSG_SIZE);

                	
						PUBLIC NATIVE STRING DNAERROR(INT ERROR_NO);

                	
						PUBLIC FUNCTION DNA_ERROR(BYVAL ERROR_NO AS SHORT) AS STRING

                	
						PUBLIC STATIC STRING DNA_ERROR(INT ERROR_NO)

Declarations and Examples

Searching the Knowledge Base