Summary

This article describes how to implement LM_A_CHECKOUTFILTER callback to enforce exact match of license version.

Synopsis

This article describes how to implement LM_A_CHECKOUTFILTER callback to enforce exact match of license version, or in other words, how to deny check-out when requested version is not same as licensed version.

Discussion

By default, license request of a certain version can check out a feature whose version number on FEATURE/INCREMENT line is higher than, or equal to the requested version. However, it's possible to enforce exact match of license version by implementing a custom filter function for the LM_A_CHECKOUTFILTER callback.

For example, before requesting a license feature of version "1.0", the filter function may be set for the LM_A_CHECKOUTFILTER callback as follows, so that lc_checkout() can only check out license from a FEATURE/INCREMENT line whose version number is exactly "1.0".

int myFilter (CONFIG *conf){
if (strcmp(conf->version, "1.0") == 0) {
return 0;
}
else {
return 1;
}
}
....
lc_set_attr(lm_job, LM_A_CHECKOUTFILTER, (LM_A_VAL_TYPE)myFilter);
lc_checkout(lm_job, feature, "1.0", nlic, LM_CO_NOWAIT, &code, LM_DUP_NONE);