Page History

LAC_GetLicense

The LAC_GetLicense function will retrieve the license generated from the LAC_CreateLicenseRequest function.

...

Parameters

szActivationKeyunmigrated-wiki-markup

\[in\] Activation key (for example, 9EFJK-TVJM0-MCDET-EZKXJ).

szHostidunmigrated-wiki-markup

\[in\] Hostid, in the format _type_=_value_ (for example, ] A client-side HostID, in the format HostID_type=value (for example, HOSTNAME=my_hostname)

szUrl

. 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. This value should be set to Wiki Markup\[in\] SOAP API 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]2.

szProxyHostname

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

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 Wiki Markup\[out\] Pointer to a string that will hold the license or 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 and retrieves a generated license.

...

On failure, this function returns an error code in the format described in Return SOAP API return codes.