Exponenta Banner
exponenta event 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™. status выходом является 1 и errmsg выход пуст, если контроль успешен.

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

     1


errmsg =

     ''

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

свернуть все

Имя функции лицензии в виде вектора символов. Значения feature не являются чувствительными к регистру. 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 isempty.

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

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

Поддержка