| Предыдущий | Следующий |
| SPAPI_E_INVALID_DEVINST_NAME | SPAPI_E_DEVINST_ALREADY_EXISTS |
SPAPI_E_INVALID_CLASS
SPAPI_E_INVALID_CLASS: смысл кода и диагностика
SPAPI_E_INVALID_CLASS — HRESULT, относящийся к области SetupAPI. Класс установки устройства отсутствует или задан неверно.
Применительно к SPAPI_E_INVALID_CLASS код относится к SetupAPI и обычно связан с INF-файлом, набором сведений об устройствах, очередью файлов, экземпляром устройства или выбором драйвера.
Практический вывод для SPAPI_E_INVALID_CLASS: этот HRESULT фиксирует описанное условие, но сам по себе не показывает, какой участник операции первым нарушил контракт. Для SPAPI_E_INVALID_CLASS найдите первый вызов, вернувший статус, и только после этого меняйте конфигурацию подсистемы SetupAPI.
Как читать имя SPAPI_E_INVALID_CLASS
Имя SPAPI_E_INVALID_CLASS помогает сузить поиск: INVALID — недопустимое значение или состояние; CLASS — класс объекта. Эти части имени не заменяют документацию API, но позволяют проверить, что журнал и код относятся к одному и тому же условию.
Проверка причины
Применительно к SPAPI_E_INVALID_CLASS формулировка указывает на недопустимые данные или состояние. Применительно к SPAPI_E_INVALID_CLASS сохраните исходное представление до нормализации и проверяйте структуру на той границе, где её принимает API.
- Для SPAPI_E_INVALID_CLASS сопоставьте фактическое значение, структуру и версию входных данных с документированным контрактом.
- При разборе SPAPI_E_INVALID_CLASS запишите hardware ID, device instance ID, ClassGuid, выбранный INF и фактически разрешённую секцию.
- При разборе SPAPI_E_INVALID_CLASS проверьте setupapi.dev.log и первую строку, где установка отклоняет INF или действие с устройством.
- При разборе SPAPI_E_INVALID_CLASS сверьте синтаксис секций/директив, стиль INF и наличие пакета в Driver Store.
- При разборе SPAPI_E_INVALID_CLASS завершите активную file queue или операцию с devinfo set перед изменением заблокированных объектов.
Диагностический минимум
- Для SPAPI_E_INVALID_CLASS сохраните полный фрагмент setupapi.dev.log с контекстом до и после HRESULT.
- Для SPAPI_E_INVALID_CLASS проверьте перечисление Plug and Play заново и не используйте устаревший SP_DEVINFO_DATA.
- Для SPAPI_E_INVALID_CLASS валидируйте INF штатными средствами на копии пакета до повторной установки.
Как подтвердить исправление
Применительно к SPAPI_E_INVALID_CLASS для SPAPI_E_INVALID_CLASS недостаточно скрыть ошибку повтором. Применительно к SPAPI_E_INVALID_CLASS после изменения воспроизведите исходную операцию, проверьте конечное состояние объекта и убедитесь, что ресурсы освобождаются без потери первичного HRESULT.
Ссылки по SPAPI_E_INVALID_CLASS
Нужно найти другой код? Найти другой код состояния или ошибки.