Exponenta Banner

license

Получите статус лицензии, протестируйте наличие лицензии продукта или проверьте лицензию функции

Свернуть все на странице

Синтаксис

license
license('inuse')
S = license('inuse')
S = license('inuse',feature)
status = license('test',feature)
license('test',feature,toggle)
[status,errmsg] = license('checkout',feature)

Описание

Используйте функцию лицензии, чтобы вернуть номер используемой лицензии, перечислите лицензии, взятые на изменение в текущем сеансе, перечислите лицензии, извлеченные пользователем, определите, извлечен ли конкретный продукт из лицензии и проверьте конкретный продукт в лицензии. Для выполнения задач управления лицензиями, включая обновление или деактивацию лицензии, см. раздел Управление вашими лицензиями.

license возвращает номер лицензии для этого MATLAB® продукт. Значение возврата может также быть нечисловым, для примера, 'demo' для демонстрационной версии MATLAB, или 'student', для студенческой версии MATLAB.

пример

license('inuse') отображает список лицензий, взятых на изменение в текущем сеансе работы с MATLAB. Список продуктов алфавитный по имени функции лицензии. Эти имена совпадают с допустимыми значениями для feature вход.

пример

S = license('inuse') возвращает массив структур, указывающих на взятые на изменение лицензии и имя пользователя каждого получившего лицензию.

пример

S = license('inuse',feature) проверяет, задан ли продукт feature взят на изменение в текущем сеансе работы с MATLAB. Если продукт взят на изменение, то license возвращает имя продукта и имя пользователя получателя. В противном случае поля S пусты.

пример

status = license('test',feature) проверяет, существует ли лицензия для продукта, заданного feature.

license('test',feature,toggle) включает или отключает проверку продукта, заданного feature, в зависимости от значения toggle.

пример

[status,errmsg] = license('checkout',feature) извлекает лицензию для указанного продукта. Если вы задаете необязательный второй выходной аргумент, errmsg, затем license возвращает текст любого сообщения об ошибке, обнаруженного в случае неудачного завершения операции.

Примеры

свернуть все

Отображение списка используемых лицензий. license отображает список продуктов в алфавитном порядке по имени функции лицензии для вашего строения.

license('inuse')
image_toolbox
map_toolbox
matlab

Получите список используемых лицензий с информацией о каждом пользователе. license возвращает массив структур.

S = license('inuse');

Просмотр первого элемента S.

S(1)
ans = 

    feature: 'image_toolbox'
       user: 'juser'

Определите, используется ли лицензия для MATLAB. Если лицензия используется, то S - массив структур с непустыми полями.

S = license('inuse','MATLAB')
S = 

    feature: 'matlab'
       user: 'jsmith'

Определите, существует ли лицензия для Mapping Toolbox™. Если лицензия существует, тогда license возвращает 1.

status = license('test','MAP_Toolbox')
status =

    1

Ознакомьтесь с лицензией на Control System Toolbox™. The status выход 1 и errmsg в случае успешного взятия на изменение выход пуст.

[status,errmsg] = license('checkout','Control_Toolbox')
status =

     1


errmsg =

     ''

Входные параметры

свернуть все

Имя функции, заданное как вектор символов. Значения feature не зависят от регистра. The INCREMENT линии в файле лицензии указывают на действительные функции. Чтобы найти файл лицензии, смотрите Где находятся файлы лицензии для MATLAB?

Возможность проверить существование лицензии продукта, заданная как 'enable' или 'disable'.

  • Если toggle является 'enable', затем синтаксис, license('test',feature) возвращает 1 когда лицензия продукта существует и 0 если лицензия продукта не существует.

  • Если toggle является 'disable', затем синтаксис, license('test',feature) всегда возвращается 0 (лицензия продукта не существует) для указанного продукта.

Примечание

Отключение теста для определенного продукта может повлиять на другие тесты на существование лицензии, а не только на тесты, выполняемые license команда.

Выходные аргументы

свернуть все

Взятые на изменение продукты, возвращенные как массив структур, где каждая структура представляет собой взятую на изменение лицензию. Структуры содержат два поля:

  • feature - имя функции лицензии

  • user - имя пользователя лица, получившего лицензию

Если поля пусты, продукт в данный момент не взят на изменение.

Статус тестирования или оформления заказа, возвращенный как 1 или 0.

  • При тестировании на наличие лицензии 1 указывает, что лицензия существует, и 0 указывает, что лицензия не существует.

    Наличие лицензии не обязательно означает, что лицензия может быть извлечена или что продукт установлен. Если все ключи продукта используются, то тест все равно вернёт 1, но реальная касса провалится.

  • При оформлении лицензии 1 указывает, что выдача выполнена успешно, и 0 указывает, что license функции не удалось извлечь лицензию.

Сообщение об ошибке для неудачной проверки лицензии, возвращенное как вектор символов. Если оформление успешно, то errmsg пуст.

Сообщения об ошибке обычно указывают, как можно решить проблему. Для примера:

License checkout failed.
License Manager Error -5
Cannot find a license for FEATURENAME.

Troubleshoot this issue by visiting:
https://www.mathworks.com/support/lme/R2021b/5

Ошибка оформления лицензии может зависеть от того, какой тип лицензии у вас есть.

Совет

  • Войдите в свою MathWorks® Учетная запись для получения дополнительной информации обо всех лицензиях, связанных с вашей учетной записью, таких как тип лицензии, использование продукта и сведения об истечении срока действия.

  • Для выполнения задач управления лицензиями, включая обновление или деактивацию лицензии, см. раздел Управление вашими лицензиями.

См. также

| |

Темы

Представлено до R2006a

Документация MATLAB

Поддержка