KCML_Lic_Acquire

Purpose

Consume an application license and store it in $PSTAT

Definition

DEFSUB 'KCML_Lic_Acquire(sLicSection$, sLicKey$, nLimit) AS KCML_LIC_STATUS

Parameters

sLicSection	Licence file section
sLicKey	4-byte license key name, must be unique.
nLimit	Optional license limit, pass in zero to check against lic.txt

Return

Returns an KCML_LIC_STATUS enumeration

Description

Counts the number of application licenses used in $PSTAT and then verifies that against the maximum, nLimit. Application licences are counted in the same way as foreground KCML licences. If nLimit is zero, then the limit is taken from the license file. Upto eight different 4-byte keys can be stored in $PSTAT. Requires an extended $PSTAT to be configured.

See also

Internal KCML Functions, Internally defined structures and Internally defined enumerations and constants.