Что означает код HRESULT 0x80040112 (CLASS_E_NOTLICENSED)?

 
Предыдущий Следующий
CLASS_E_CLASSNOTAVAILABLE VIEW_E_DRAW

CLASS_E_NOTLICENSED

CLASS_E_NOTLICENSED: интерпретация кода и контроль исправления

HRESULT CLASS_E_NOTLICENSED соответствует значению 0x80040112. Его штатное описание: «Для использования класса отсутствует лицензия.»

Для CLASS_E_NOTLICENSED старший бит HRESULT делает значение ошибкой. Константа CLASS_E_NOTLICENSED объявлена в winerror.h и относится к области «COM/DCOM: активация, регистрация и безопасность».

Где проходит граница ошибки

Для CLASS_E_NOTLICENSED код относится к инфраструктуре COM: активации класса, регистрации CLSID/IID, запуску сервера, RPC-каналу, модели апартаментов или проверке безопасности. Для CLASS_E_NOTLICENSED диагностика должна начинаться с первого вызова CoCreateInstance/CoGetClassObject либо операции маршалинга, а не с последующей ошибки приложения.

Для CLASS_E_NOTLICENSED не следует начинать с очистки состояния или переустановки компонента. Для CLASS_E_NOTLICENSED сначала необходимо привязать результат к одному вызову, объекту и поколению его состояния.

В имени CLASS_E_NOTLICENSED закодированы ориентиры для расследования: CLASS — COM-класс; NOTLICENSED — технический признак «notlicensed». Для CLASS_E_NOTLICENSED эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

Что означает код: признаки в имени константы

Компонент имени CLASS уточняет смысл CLASS_E_NOTLICENSED: речь идёт про COM-класс. Для CLASS_E_NOTLICENSED эту границу следует воспроизвести отдельно от последующей обработки ошибки.

При разборе CLASS_E_NOTLICENSED обозначение NOTLICENSED связывает код с темой «технический признак «notlicensed»». До повторной проверки CLASS_E_NOTLICENSED сохраните входные данные без нормализации.

Для CLASS_E_NOTLICENSED в техническом контексте особенно важны: CLSID, IID, провайдер. При расследовании CLASS_E_NOTLICENSED их следует проверять как связанные части одной операции, а не как независимые симптомы.

Что сохранить до изменений

  • Для воспроизводимого отчёта по CLASS_E_NOTLICENSED нужно записать CLSID, IID, CLSCTX, архитектуру клиента и сервера.
  • В первичном журнале по CLASS_E_NOTLICENSED нужно проверить RunAs, LaunchPermission, AccessPermission и фактический маркер доступа.

Последовательность проверки

  1. Для CLASS_E_NOTLICENSED: Определить точный COM-вызов и сохранить исходный HRESULT до преобразования исключением; не удаляйте исходные данные до завершения сравнения.
  2. Для CLASS_E_NOTLICENSED: Проверить регистрацию класса и интерфейса в представлении реестра нужной разрядности; повторите шаг на исправном контрольном примере.
  3. Для CLASS_E_NOTLICENSED: Проверить запуск сервера вручную под той же учётной записью и с тем же окружением; сохраните первый hresult и точное время результата.
  4. Для CLASS_E_NOTLICENSED: Сопоставить разрешения DCOM с реальными SID клиента и серверной идентичности; отдельно отметьте изменение состояния объекта.
  5. Для CLASS_E_NOTLICENSED: После исправления повторить активацию из исходного апартамента и проверить корректное освобождение объектов; все остальные условия оставьте неизменными.

Исправление и подтверждение результата

Корректирующее действие для CLASS_E_NOTLICENSED должно устранять условие «Для использования класса отсутствует лицензия» на уровне CLSID. Для CLASS_E_NOTLICENSED простое подавление HRESULT, бесконечный повтор или очистка всех настроек не доказывают восстановление контракта.

Для CLASS_E_NOTLICENSED контрольный прогон должен включать успешный путь, повтор операции после изменения состояния и корректное освобождение ресурсов. Для CLASS_E_NOTLICENSED один случайный успех недостаточен.

Технические ссылки

Нужно найти другой код? Найти другой код состояния или ошибки.