PvAddLicense()

Library > Products > Pervasive.SQL > Pervasive.SQL 9.1 > DTI Programmer's Guide > Distributed Tuning Interface Reference > PvAddLicense()

Previous

DTI Programmer's Guide (9.1 revision 1)

Next

PvAddLicense()

Show this topic in Library frames

Installs the specified license from the computer indicated by with the connection.

Header file: DTILICENSE.HRequires: W3DBAV80.DLL or higher version

Syntax

BTI_API PvAddLicense( 
	BTI_LONG        hConnection, 
	BTI_CHAR_PTR    license);

Arguments


In	hConnection	Connection handle that identifies the server. Connection handles are obtained with the PvConnectServer() function.
In	license	License key to be added.

Return Values


P_OK	The operation completed successfully
P_E_FAIL	The operation did not complete successfully
PS_E_LIC_ALREADY_INSTALLED	The license is already installed.
PS_E_LIC_INVALID	The license key specified is invalid.

Remarks

The following preconditions must be met:

DTI session started by calling PvStart().

Connection established by PvConnectServer() or if you are performing the operation on a local machine, P_LOCAL_DB_CONNECTION may be used as the connection handle.

Example

BTI_CHAR_PTR add_lic = "ERXVD3U4ZS9KR94QPDHV5BN2"; 
status = PvAddLicense(P_LOCAL_DB_CONNECTION, add_lic);

See Also

PvStart()
PvDeleteLicense()
PvGetLicenses()
PvStop()

Chapter contents
Publication contents

Prev topic: PvAddIndex()
Next topic: PvAddTable()