Что означает код HRESULT 0x800401F6 (CO_E_APPSINGLEUSE)?

 
Предыдущий Следующий
CO_E_APPNOTFOUND CO_E_ERRORINAPP

CO_E_APPSINGLEUSE

Разбор CO_E_APPSINGLEUSE: данные для диагностики

Windows возвращает CO_E_APPSINGLEUSE (0x800401F6), когда выполняется следующее условие: Приложение нельзя запускать более одного раза.

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

Техническая граница

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

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

В имени CO_E_APPSINGLEUSE закодированы ориентиры для расследования: APP — приложение; SINGLEUSE — одноразовый сервер. Для CO_E_APPSINGLEUSE эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

Что сообщает Windows: признаки в имени константы

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

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

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

Данные для воспроизведения

  • На границе сбоя по CO_E_APPSINGLEUSE нужно сохранить командную строку COM-сервера, AppID и параметры LocalServer32/InprocServer32.
  • Для сравнения с исправным случаем по CO_E_APPSINGLEUSE нужно сохранить события DistributedCOM/SCM и первичную RPC-ошибку.

Практическая диагностика

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

Восстановление рабочего пути

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

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

Ссылки Microsoft

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