LAC_GetLicense
The LAC_GetLicense function will retrieve the license generated from the LAC_CreateLicenseRequest function.
Prototype
LAC_STATUS LAC_GetLicense
(
const char *szActivationKey,
const char *szHostid,
const char *szUrl,
const char *szProxyHostname,
int nProxyPort,
const char *szProxyUsername,
const char *szProxyPassword,
char *szResult
);
Parameters
szActivationKey
Wiki Markup |
---|
szActivationKey
\[in\] Activation key (e.g. 9EFJK-TVJM0-MCDET-EZKXJ) |
szHostid
Wiki Markup |
---|
szHostid \[in\] Hostid in the format type=value (e.g. HOSTNAME=my_hostname) szUrl |
szUrl
Wiki Markup |
---|
\[in\] SOAP API endpoint url (it should be set to [http://license.x-formation.com/soap/type/enduser/version/1)|http://license.x-formation.com/soap/type/enduser/version/1%29] |
szProxyHostname
Wiki Markup |
---|
szProxyHostname \[in\] An optional client-side proxy host to be used with a request (should be NULL if not relevant). nProxyPort |
nProxyPort
Wiki Markup |
---|
\[in\] An optional client-side proxy port number to be used with a request (should be 0 if not relevant).
szProxyUsername
|
szProxyUsername
Wiki Markup |
---|
\[in\] An optional client-side proxy username to be used with a request (should be NULL if not relevant). |
szProxyPassword
Wiki Markup |
---|
szProxyPassword
\[in\] An optional client-side proxy password to be used with a request (should be NULL if not relevant). |
szResult
Wiki Markup |
---|
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. |
...
On success, this function returns the status code LAC_SUCCESS and returns retrieves a generated license.
On failure, this function returns one of the error codes from LAC_STATUS enum and a proper error message.an error code in the format described in Return codes.
For a gSoap error, the The special case is gSoap error. The returned value will be in rage the range of 899-999 and is equivalent to the gSoap error code with added , plus LAC_SOAP_BASE = 900.
There In this case, there is no error message then, and most popular gSoap errors are specified within LAC_STATUS enum.