The LAC_CreateLicenseRequest function will create a license request and generate a license.
Prototype
LAC_STATUS LAC_CreateLicenseRequest
(
const char *szActivationKey,
const char *szHostid,
const char *szUrl,
const char *szProxyHostname,
int nProxyPort,
const char *szProxyUsername,
const char *szProxyPassword,
char *szResult
);
Parameters
szActivationKey
[in] Activation key (for example, 9EFJK-TVJM0-MCDET-EZKXJ).
szHostid
[in] An optional client-side HostID, in the format type=value (for example, HOSTNAME=my_hostname). This value should be NULL if not relevant. See your license manager documentation (for example, the LM-X Developers Manual) for valid HostID types. You may also use a comma-separated list of multiple HostIDs, in which case LAC will select the first appropriate value. When entering an Ethernet HostID, the format must be 12 hexadecimal characters with or without separators; for example, 48-2C-6A-1E-59-3D, 48:2C:6A:1E:59:3D or 482C6A1E593D. Older LM-X Ethernet HostIDs that are 16 characters in length are no longer supported.
szUrl
[in] SOAP API endpoint URL. This value should be set to http://license.x-formation.com/soap/type/enduser/version/1
.
szProxyHostname
[in] An optional client-side proxy host to be used with a request. This value should be NULL if not relevant.
nProxyPort
[in] An optional client-side proxy port number to be used with a request. This value should be 0 if not relevant.
szProxyUsername
[in] An optional client-side proxy username to be used with a request. This value should be NULL if not relevant.
szProxyPassword
[in] An optional client-side proxy password to be used with a request. This value should be NULL if not relevant.
szResult
[out] Pointer to a string that will hold the error message. The string length can be up to LAC_MAX_RESPONSE_LENGTH.
Return Values
On success, this function returns the status code LAC_SUCCESS. The license can then be retrieved using LAC_GetLicense.
On failure, this function returns an error code in the format described in Return codes.