Перейти к основному содержимому

llkGetFeatureInfo

Описание

Дает информацию о компоненте(feature), который находится в составе активированной лицензии

Важно

Функция выделяет память, для её освобождения необходимо вызвать функцию llkFree

Синтаксис

llkGetFeatureInfo
LLKStatus LLK_API llkGetFeatureInfo(uint32_t featureId, char** featureInfoJson);

Параметры

ПараметрОписание
featureIdНомер фичи (компонента)
featureInfoJsonУказатель на возвращаемую информацию о заданной фиче в формате JSON

Возвращаемые значения

ЗначениеКодОписание
LLK_OK0Запрос выполнен успешно
LLK_INVALID_PARAMETER1Параметр featureInfoJson нулевой указатель
LLK_FEATURE_NOT_FOUND2Фича (компонент) не нашлась в лицензии (в продукте отсутствует)
LLK_LICENSE_NOT_ACTIVATED_YET12Лицензия не активирована, или не инициализировано окружение методом вызова функции llkActivateLicense
LLK_INTERNAL_TRY_AGAIN701В случае 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