Что означает код HRESULT 0x80004028 (CO_E_CLRNOTAVAILABLE)?

 
Предыдущий Следующий
CO_E_CLASS_DISABLED CO_E_ASYNC_WORK_REJECTED

CO_E_CLRNOTAVAILABLE

CO_E_CLRNOTAVAILABLE: значение HRESULT и практическая диагностика

Windows возвращает CO_E_CLRNOTAVAILABLE (0x80004028), когда выполняется следующее условие: Среда Common Language Runtime недоступна.

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

Почему важен контекст вызова

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

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

В имени CO_E_CLRNOTAVAILABLE закодированы ориентиры для расследования: CLRNOTAVAILABLE — технический признак «clrnotavailable». Для CO_E_CLRNOTAVAILABLE эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

Интерпретация HRESULT: признаки в имени константы

Маркер CLRNOTAVAILABLE в CO_E_CLRNOTAVAILABLE направляет проверку на технический признак «clrnotavailable». Для CO_E_CLRNOTAVAILABLE сопоставьте этот признак с фактическими параметрами первого неуспешного вызова.

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

Минимальный набор свидетельств

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

Как локализовать причину

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

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

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

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

Полезные материалы

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