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