Что означает код HRESULT 0x80040161 (CAT_E_NODESCRIPTION)?

Код состояния / ошибки:

Категория:

Имя константы:

Источник:

Подсистема (Facility):

Операционная система:

Описание:

Описание не найдено.

Предыдущий	Следующий
CAT_E_CATIDNOEXIST	CS_E_PACKAGE_NOTFOUND

CAT_E_NODESCRIPTION

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

Windows возвращает CAT_E_NODESCRIPTION (0x80040161), когда выполняется следующее условие: Описание не найдено.

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

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

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

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

В имени CAT_E_NODESCRIPTION закодированы ориентиры для расследования: NO — отсутствие; DESCRIPTION — описание. Для CAT_E_NODESCRIPTION эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

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

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

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

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

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

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

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

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

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

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

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

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

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