Page History

LAC_CreateLicenseRequest

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 (e.g. 9EFJK-TVJM0-MCDET-EZKXJ)

*szHostid*
szHostid
\[in\] Hostid in the format type=value (e.g. HOSTNAME=my_hostname)
szUrl

szUrl

\[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

szProxyHostname
\[in\] An optional client-side proxy host to be used with a request (should be NULL if not relevant).
nProxyPort

nProxyPort

\[in\] An optional client-side proxy port number to be used with a request (should be 0 if not relevant).
szProxyUsername

szProxyUsername

\[in\] An optional client-side proxy username to be used with a request (should be NULL if not relevant).

szProxyPassword

szProxyPassword
\[in\] An optional client-side proxy password to be used with a request (should be NULL if not relevant).

szResult

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.

On failure, functions return one of the error codes form LAC_STATUS enum and a proper error message.this function returns 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 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.