llkGetFeatureInfo
Описание
Дает информацию о компоненте(feature), который находится в составе активированной лицензии
Важно
Функция выделяет память, для её освобождения необходимо вызвать функцию llkFree
Синтаксис
llkGetFeatureInfo
LLKStatus LLK_API llkGetFeatureInfo(uint32_t featureId, char** featureInfoJson);
Параметры
Параметр | Описание |
---|---|
featureId | Номер фичи (компонента) |
featureInfoJson | Указатель на возвращаемую информацию о заданной фиче в формате JSON |
Возвращаемые значения
Значение | Код | Описание |
---|---|---|
LLK_OK | 0 | Запрос выполнен успешно |
LLK_INVALID_PARAMETER | 1 | Параметр featureInfoJson нулевой указатель |
LLK_FEATURE_NOT_FOUND | 2 | Фича (компонент) не нашлась в лицензии (в продукте отсутствует) |
LLK_LICENSE_NOT_ACTIVATED_YET | 12 | Лицензия не активирована, или не инициализировано окружение методом вызова функции llkActivateLicense |
LLK_INTERNAL_TRY_AGAIN | 701 | В случае llkGetFeatureInfo код ошибки говорит о том, что операционная система не смогла выделить память. Требуется повторить запрос |
Примеры
C++ пример
char* featureInfoJson = nullptr;
const uint32_t featureId = 0;
const LLKStatus status = llkGetFeatureInfo(featureId, &featureInfoJson);
if (status == LLKStatus::LLK_OK) {
std::cout << json::parse(featureInfoJson).dump(1) << std::endl;
}
/*nullptr is ok for llkFree*/
llkFree(featureInfoJson);
Пример успешного вывода
{
"Feature": {
"ID": 0,
"Name": "Test_0",
"executionsLimit": 0,
"licenseType": 2,
"validFromDate": 1700410608,
"validUpToDate": 1701993600
}
}
В примере пользуемся библиотекой nlohmann json, для форматирования и печати полученных данных
Полное описание featureInfoJson
Поле | Описание |
---|---|
ID | Уникальный номер фичи |
Name | Имя фичи (строка) |
executionsLimit | Количество запусков |
licenseType | Модель (тип) лицензирования |
validFromDate | Метка времени, начиная с которого фича доступна в составе текущей лицензии |
validUpToDate | Метка времени, по достижению которой фича перестанет быть доступной |
Информация
Подробнее про все модели ограничений лицензируемых фич в разделе LLKFeatureLicenseType
История версий
- Добавлено в
1.0.0