Что означает код HRESULT 0x80040166 (CS_E_CLASS_NOTFOUND)?

 
Предыдущий Следующий
CS_E_NOT_DELETABLE CS_E_INVALID_VERSION

CS_E_CLASS_NOTFOUND

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

Windows возвращает CS_E_CLASS_NOTFOUND (0x80040166), когда выполняется следующее условие: Указанный CLSID не найден в данных установки ПО в Active Directory.

Для CS_E_CLASS_NOTFOUND старший бит HRESULT делает значение ошибкой. Константа CS_E_CLASS_NOTFOUND объявлена в winerror.h и относится к области «Class Store и развёртывание COM-классов».

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

Для CS_E_CLASS_NOTFOUND hRESULT относится к хранилищу классов, используемому для публикации и установки COM-компонентов. Для CS_E_CLASS_NOTFOUND проверять нужно путь пакета, схему каталога, версию и доступность сетевого источника, не ограничиваясь локальной регистрацией CLSID.

Для CS_E_CLASS_NOTFOUND само имя кода не доказывает первопричину. Для CS_E_CLASS_NOTFOUND оно указывает, на каком контракте подсистема обнаружила нарушение; первичным считается первый вызов, который вернул HRESULT.

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

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

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

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

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

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

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

  • В первичном журнале по CS_E_CLASS_NOTFOUND нужно сохранить CLSID, путь пакета и версию записи Class Store.
  • На границе сбоя по CS_E_CLASS_NOTFOUND нужно зафиксировать контроллер домена и сетевой путь, к которому обращался клиент.
  • Для сравнения с исправным случаем по CS_E_CLASS_NOTFOUND нужно проверить права чтения каталога и пакета под учётной записью компьютера.
  • До повторной попытки по CS_E_CLASS_NOTFOUND нужно сохранить схему и атрибуты объекта публикации в каталоге.
  • Для воспроизводимого отчёта по CS_E_CLASS_NOTFOUND нужно зафиксировать результат локальной регистрации и установки пакета отдельно.

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

  1. Для CS_E_CLASS_NOTFOUND: Проверить существование записи класса и связанного пакета в каталоге; отдельно отметьте изменение состояния объекта.
  2. Для CS_E_CLASS_NOTFOUND: Проверить сетевую доступность источника из контекста целевого компьютера; все остальные условия оставьте неизменными.
  3. Для CS_E_CLASS_NOTFOUND: Сопоставить версию схемы и пакета с версией клиента; не удаляйте исходные данные до завершения сравнения.
  4. Для CS_E_CLASS_NOTFOUND: Исключить конфликт дублирующихся записей и устаревших путей; повторите шаг на исправном контрольном примере.
  5. Для CS_E_CLASS_NOTFOUND: После исправления выполнить установку на чистом клиенте и проверить активацию класса; сохраните первый hresult и точное время результата.

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

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

Для CS_E_CLASS_NOTFOUND зафиксируйте результат до и после изменения одними и теми же средствами. Для CS_E_CLASS_NOTFOUND сравнивайте не только HRESULT, но и конечное состояние объекта, побочные эффекты и события подсистемы.

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

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