Что означает код HRESULT 0x80040111 (CLASS_E_CLASSNOTAVAILABLE)?

 
Предыдущий Следующий
CLASS_E_NOAGGREGATION CLASS_E_NOTLICENSED

CLASS_E_CLASSNOTAVAILABLE

Разбор CLASS_E_CLASSNOTAVAILABLE: данные для диагностики

CLASS_E_CLASSNOTAVAILABLE имеет значение 0x80040111 (-2147221231 в знаковом 32-битном представлении). Фабрика классов не может предоставить запрошенный класс.

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

Контекст подсистемы

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

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

В имени CLASS_E_CLASSNOTAVAILABLE закодированы ориентиры для расследования: CLASS — COM-класс; NOT — отсутствие требуемого условия; AVAILABLE — доступность ресурса. Для CLASS_E_CLASSNOTAVAILABLE эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

Смысл результата: признаки в имени константы

При разборе CLASS_E_CLASSNOTAVAILABLE обозначение CLASS связывает код с темой «COM-класс». До повторной проверки CLASS_E_CLASSNOTAVAILABLE сохраните входные данные без нормализации.

При разборе CLASS_E_CLASSNOTAVAILABLE обозначение NOT связывает код с темой «отсутствие требуемого условия». До повторной проверки CLASS_E_CLASSNOTAVAILABLE сохраните входные данные без нормализации.

Для CLASS_E_CLASSNOTAVAILABLE часть AVAILABLE относится к области «доступность ресурса». При разборе CLASS_E_CLASSNOTAVAILABLE проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.

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

Диагностические данные

  • На границе сбоя по CLASS_E_CLASSNOTAVAILABLE нужно зафиксировать модель апартамента и историю CoInitializeEx в текущем потоке.
  • Для сравнения с исправным случаем по CLASS_E_CLASSNOTAVAILABLE нужно зафиксировать личность клиента и сервера, уровень олицетворения и authentication blanket.

Проверка по шагам

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

Корректирующие действия

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

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

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

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