isc_license_add()

From InterBase

Go Up to API Function Reference


Adds a certificate ID and key pair to the InterBase license file.

Note: This function is based on the licensing with any version prior to InterBase 7.

Syntax

 int isc_license_add(char *cert_id, char *cert_key)
Parameter Type Description

<cert_id>

char *

Pointer to a NULL-terminated character buffer containing the certificate ID to be added.

<cert_key>

char *

Pointer to a NULL-terminated character buffer containing the certificate key to be added.

Description

Adds a line containing the specified certificate ID and key pair to the ib_license.dat file in the InterBase install directory. This ID/key pair must be a valid authorization code obtained from InterBase. InterBase might require several authorization codes to run and you must call the function once for each ID/key pair you need to add.

Return value

isc_license_add() returns isc_license_msg_restart if it successfully adds the authorization code. If it returns an error, pass the return value to isc_license_get_msg() to obtain the exact error message. The possible return values are:

Error codes from isc_license_add()
Return Description

isc_license_msg_restart

Authorization code was successfully added.

isc_license_msg_writefailed

The authorization code could not be written.

isc_license_msg_dupid

The authorization code was not added to the license file because it is a duplicate of one already present in the file.

isc_license_msg_convertfailed

The ID/key combination is invalid.

Advance To: