Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Parameters

szActivationKey

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

szHostidunmigrated-wiki-markup

\[in\] An optional A client-side HostID, in the format HostID_type_=_value_ (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.)

When entering an Ethernet HostID, the format must be 12 hexadecimal characters with or without separators; for example, 48 This value should be NULL if not relevant. See your license manager documentation (for example, the _LM-X Developers Manual_) for valid HostID types. You may also use a comma-separated list of multiple HostIDs, in which case LAC will select the first appropriate value. When entering an Ethernet HostID, the format must be 12 hexadecimal characters with or without separators; for example, 48-2C-6A-1E-59-3D, 4800:2C50:6A:1E:59:3D or 482C6A1E593D. Older LM-X Ethernet HostIDs that are 16 characters in length are no longer supported.

szUrl

A7:B6-CC-1A or ABC82739BEFA. LM-X 16-character encrypted Ethernet HostIDs are no longer supported.

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].

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

Wiki Markup
\[in\] An optional client-side proxy port number to be used with a request. This value should be 0 if not relevant.

szProxyUsername

Wiki Markup
\[in\] An optional client-side proxy username to be used with a request. This value should be NULL if not relevant.

szProxyPassword

Wiki Markup
\[in\] An optional client-side proxy password to be used with a request. This value 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 error message. The string length can be up to Wiki Markup\[out\] Pointer to a string that will hold the 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. The license can then be retrieved using LAC_GetLicense.

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