The LMX_SetOption function sets flags that change licensing behavior prior to license checkout.
Prototype
LMX_STATUS LMX_SetOption
(
LMX_HANDLE LmxHandle,
LMX_SETTINGS eOption,
const void *pSetting
);
Parameters
LmxHandle
[in/out] LM-X handle.
eOption
See the eOption information for the specific option, listed below.
pSetting
See the Setting information for the specific option, listed below.
Note: To avoid warnings when using the pSetting parameter, you can typecast it to the type (LMX_OPTION).
LMX_SetOption functions
The functions for LMX_SetOption are listed below.
Note: Unless otherwise specified, the LMX_SetOption options affect checkout requests.
LMX_OPT_HEARTBEAT_CHECKOUT_SUCCESS_FUNCTION
LMX_OPT_HEARTBEAT_CHECKOUT_FAILURE_FUNCTION
LMX_OPT_HEARTBEAT_RETRY_FEATURE_FUNCTION
LMX_OPT_HEARTBEAT_CONNECTION_LOST_FUNCTION
LMX_OPT_HEARTBEAT_EXIT_FUNCTION
LMX_OPT_HEARTBEAT_CALLBACK_VENDORDATA
LMX_OPT_AUTOMATIC_HEARTBEAT_ATTEMPTS
LMX_OPT_AUTOMATIC_HEARTBEAT_INTERVAL
LMX_OPT_ALLOW_MULTIPLE_SERVERS
LMX_OPT_HOSTID_COMPARE_FUNCTION
LMX_OPT_HOSTID_CACHE_CLEANUP_INTERVAL
LMX_OPT_CUSTOM_HOSTID_FUNCTION
LMX_OPT_SERVERSIDE_REQUEST_STRING
Return values
On success, this function returns the status code LMX_SUCCESS.
On failure, this function returns an error code in the format described in Return codes.
Remarks
Note that some of the flags are used in combination with checkout requests. This enables you to set flags for single checkout requests if needed. For example:
/* First checkout request requires an exact version match to pass */
LMX_SetOption(..., LMX_OPT_EXACT_VERSION, (LMX_OPTION) 1);
LMX_Checkout(...);
/* Second checkout request does not require an exact version match to pass
but can have a higher version in license file than function request */
LMX_SetOption(..., LMX_OPT_EXACT_VERSION, (LMX_OPTION) 0);
LMX_Checkout(...);