LAC_GetLicense
The LAC_GetLicense function will retrieve the license generated from the LAC_CreateLicenseRequest function.
...
Parameters
szActivationKey
\[in\] Activation key (e.g. (for example, 9EFJK-TVJM0-MCDET-EZKXJ). Wiki Markup
szHostidunmigrated-wiki-markup
\[in\] Hostid in the format ] A client-side HostID, in the format HostID_type=value (e.g. (for example, HOSTNAME=my_hostname). To provide more than one HostID, use a comma-separated HostID list (HostID_type1=value1, HostID_type2=value2, etc.), from which LAC will select the first appropriate value. This value should be NULL if not relevant. See your license manager documentation for valid HostID types. (For LM-X License Manager, see the LM-X Developers Manual.)
szUrl
\[in\] SOAP API endpoint url (it should be set to [endpoint URL. This value 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] Wiki Markup
szProxyHostname
Wiki Markup |
---|
\[in\] An optional client-side proxy host to be used with a request (should be NULL if not relevant). |
nProxyPort
Wiki Markup |
---|
\[in\] An optional client-side proxy port number to be used with a request (should be 0 if not relevant). |
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 |
---|
\[in\] An optional client-side proxy password to be used with a request (should be NULL if not relevant). |
szResult
2.
szProxyHostname
[in] An optional client-side proxy host to be used with a request. This value should be NULL if not relevant.
Note: This function will attempt to contact LAC directly if no proxy is specified, so if you have a firewall or router that redirects traffic, ensure your configuration handles this correctly.
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 license or error message. The string length can be up to \[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. Wiki Markup
Return Values
On success, this function returns the status code LAC_SUCCESS and retrieves a generated license.
You may need to call GetLicense multiple times after creating a license request, because it can take from a few seconds up to a few minutes to get the generated license. Your application should account for this by displaying an appropriate wait icon/message and calling the LAC_GetLicense function multiple times until the request succeeds. We recommend calling LAC_GetLicense no more often than once every 10 seconds.
On failure, this function returns an error code in the format described in Return codes.For a gSoap error, the returned value will be in the range of 899-999 and is equivalent to the gSoap error code, plus LAC_SOAP_BASE = 900. In this case, there is no error message, and most popular gSoap errors are specified within LAC_STATUS enum SOAP API return codes.