Что означает код HRESULT 0x80110448 (COMADMIN_E_START_APP_NEEDS_COMPONENTS)?

 
Предыдущий Следующий
COMADMIN_E_ROLE_DOES_NOT_EXIST COMADMIN_E_REQUIRES_DIFFERENT_PLATFORM

COMADMIN_E_START_APP_NEEDS_COMPONENTS

Как расследовать HRESULT COMADMIN_E_START_APP_NEEDS_COMPONENTS

Windows возвращает COMADMIN_E_START_APP_NEEDS_COMPONENTS (0x80110448), когда выполняется следующее условие: Для запуска приложения в нём должен находиться хотя бы один компонент.

Для COMADMIN_E_START_APP_NEEDS_COMPONENTS старший бит HRESULT делает значение ошибкой. Константа COMADMIN_E_START_APP_NEEDS_COMPONENTS объявлена в winerror.h и относится к области «каталог и администрирование COM+».

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

Для COMADMIN_E_START_APP_NEEDS_COMPONENTS результат возвращает административный API COM+ при чтении или изменении каталога приложений, компонентов, ролей, разделов и зависимых коллекций. Для COMADMIN_E_START_APP_NEEDS_COMPONENTS изменения следует выполнять в правильной родительской коллекции и фиксировать через SaveChanges, не смешивая объекты из разных поколений каталога.

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

В имени COMADMIN_E_START_APP_NEEDS_COMPONENTS закодированы ориентиры для расследования: COMADMIN — технический признак «comadmin»; START — технический признак «start»; APP — приложение; NEEDS — технический признак «needs»; COMPONENTS — технический признак «components». Для COMADMIN_E_START_APP_NEEDS_COMPONENTS эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

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

Компонент имени COMADMIN уточняет смысл COMADMIN_E_START_APP_NEEDS_COMPONENTS: речь идёт про технический признак «comadmin». Для COMADMIN_E_START_APP_NEEDS_COMPONENTS эту границу следует воспроизвести отдельно от последующей обработки ошибки.

Компонент имени START уточняет смысл COMADMIN_E_START_APP_NEEDS_COMPONENTS: речь идёт про технический признак «start». Для COMADMIN_E_START_APP_NEEDS_COMPONENTS эту границу следует воспроизвести отдельно от последующей обработки ошибки.

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

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

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

  • Для воспроизводимого отчёта по COMADMIN_E_START_APP_NEEDS_COMPONENTS нужно сохранить имя приложения COM+, Application ID и Component CLSID.
  • В первичном журнале по COMADMIN_E_START_APP_NEEDS_COMPONENTS нужно сохранить экспорт приложения или резервную копию каталога перед ремонтом.

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

  1. Для COMADMIN_E_START_APP_NEEDS_COMPONENTS: Получить свежий объект каталога и заново Populate нужную коллекцию; не удаляйте исходные данные до завершения сравнения.
  2. Для COMADMIN_E_START_APP_NEEDS_COMPONENTS: Проверить существование родительского приложения, раздела или компонента; повторите шаг на исправном контрольном примере.
  3. Для COMADMIN_E_START_APP_NEEDS_COMPONENTS: Внести одно минимальное изменение и отдельно вызвать SaveChanges; сохраните первый hresult и точное время результата.
  4. Для COMADMIN_E_START_APP_NEEDS_COMPONENTS: Не переиспользовать объект каталога после удаления, импорта или изменения родителя; отдельно отметьте изменение состояния объекта.
  5. Для COMADMIN_E_START_APP_NEEDS_COMPONENTS: После исправления активировать компонент и проверить роли, транзакции и завершение процесса; все остальные условия оставьте неизменными.

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

Корректирующее действие для COMADMIN_E_START_APP_NEEDS_COMPONENTS должно устранять условие «Для запуска приложения в нём должен находиться хотя бы один компонент» на уровне каталог и администрирование COM+. Для COMADMIN_E_START_APP_NEEDS_COMPONENTS простое подавление HRESULT, бесконечный повтор или очистка всех настроек не доказывают восстановление контракта.

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

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

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