Что означает код HRESULT 0x80040160 (CAT_E_CATIDNOEXIST)?

 
Предыдущий Следующий
REGDB_E_PACKAGEPOLICYVIOLATION CAT_E_NODESCRIPTION

CAT_E_CATIDNOEXIST

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

HRESULT CAT_E_CATIDNOEXIST соответствует значению 0x80040160. Его штатное описание: «Указанный CATID не существует.»

Для CAT_E_CATIDNOEXIST старший бит HRESULT делает значение ошибкой. Константа CAT_E_CATIDNOEXIST объявлена в winerror.h и относится к области «OLE, буфер обмена и кеш представлений».

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

Для CAT_E_CATIDNOEXIST код относится к обмену данными OLE, структурам FORMATETC/STGMEDIUM, буферу обмена или кешу представлений внедрённого объекта. Для CAT_E_CATIDNOEXIST нужно различать формат, аспект, индекс, TYMED и фактическую доступность источника IDataObject.

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

В имени CAT_E_CATIDNOEXIST закодированы ориентиры для расследования: CATID — идентификатор категории компонентов; NO — отсутствие; EXIST — существование объекта. Для CAT_E_CATIDNOEXIST эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

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

Маркер CATID в CAT_E_CATIDNOEXIST направляет проверку на идентификатор категории компонентов. Для CAT_E_CATIDNOEXIST сопоставьте этот признак с фактическими параметрами первого неуспешного вызова.

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

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

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

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

  • Для воспроизводимого отчёта по CAT_E_CATIDNOEXIST нужно сохранить все поля FORMATETC: cfFormat, ptd, dwAspect, lindex и tymed.
  • В первичном журнале по CAT_E_CATIDNOEXIST нужно зафиксировать фактически возвращённый STGMEDIUM и владельца его освобождения.
  • На границе сбоя по CAT_E_CATIDNOEXIST нужно перечислить форматы, которые источник IDataObject объявляет доступными.
  • Для сравнения с исправным случаем по CAT_E_CATIDNOEXIST нужно записать интерфейс и метод OLE, вернувший HRESULT.
  • До повторной попытки по CAT_E_CATIDNOEXIST нужно сохранить состояние внедрённого объекта и его соединение с сервером.

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

  1. Для CAT_E_CATIDNOEXIST: Сравнить запрошенный FORMATETC с результатом EnumFormatEtc источника; не удаляйте исходные данные до завершения сравнения.
  2. Для CAT_E_CATIDNOEXIST: Проверить совместимость dwAspect, lindex и допустимых TYMED; повторите шаг на исправном контрольном примере.
  3. Для CAT_E_CATIDNOEXIST: Запросить один минимальный формат без участия кеша или буфера обмена; сохраните первый hresult и точное время результата.
  4. Для CAT_E_CATIDNOEXIST: Проверить жизненный цикл STGMEDIUM и отсутствие преждевременного ReleaseStgMedium; отдельно отметьте изменение состояния объекта.
  5. Для CAT_E_CATIDNOEXIST: После исправления обновить кеш и проверить повторное открытие сохранённого документа; все остальные условия оставьте неизменными.

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

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

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

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

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