LAC_CreateLicenseRequest
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 (e.g. 9EFJK-TVJM0-MCDET-EZKXJ)
szHostid
[in] Hostid in the format type=value (e.g. HOSTNAME=my_hostname)
szUrl
[in] SOAP API endpoint url (it 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 (should be NULL if not relevant).
nProxyPort
[in] An optional client-side proxy port number to be used with a request (should be 0 if not relevant).
szProxyUsername
[in] An optional client-side proxy username to be used with a request (should be NULL if not relevant).
szProxyPassword
[in] An optional client-side proxy password to be used with a request (should be NULL if not relevant).
szResult
[out] Pointer to a string that will hold the license or error message. The length of the string can be up to LAC_MAX_RESPONSE_LENGTH.
Return Values
On success, this function returns the status code LAC_SUCCESS.
On failure, functions return one of the error codes form LAC_STATUS enum and a proper error message.
The special case is gSoap error. The returned value will be in range of 899-999 and is equivalent to gSoap error code with added LAC_SOAP_BASE = 900.
There is no error message then, and most popular gSoap errors are specified within LAC_STATUS enum.