| Предыдущий | Следующий |
| NTE_INTERNAL_ERROR | NTE_HMAC_NOT_SUPPORTED |
NTE_UI_REQUIRED
NTE_UI_REQUIRED указывает на сбой на этапе обязательного взаимодействия с пользователем. Операция не может завершиться, пока человек не предоставит ввод — согласие, PIN, пароль, выбор смарт-карты или биометрический жест. Диагностируйте это в первом компоненте, вернувшем значение, а не в последнем UI-слое: последующая очистка и резервные попытки могут породить другие вторичные ошибки.
Начните с API, вернувшего результат
При этом результате поставщик требует или попытался выполнить шаг присутствия пользователя. Различайте контракт silent-вызова, недоступный интерактивный рабочий стол, явную отмену пользователем и политику поставщика, ограничивающую операцию активной консолью. В unattended-программе они могут выглядеть одинаково, но исправляются по-разному.
Матрица диагностических данных
- Silent- и UI-флаги, использованные при открытии поставщика или ключа
Определите window station, desktop, сеанс и идентичность процесса, в которых должен отображаться запрос.
При этом результате это отделяет обязательное присутствие пользователя по политике от отсутствия доступа к рабочему столу. - ID сеанса, desktop, состояние активной консоли, идентичность службы и факт фактического показа запроса
Проверьте, настроен ли поставщик на усиленную защиту ключа или обязательное присутствие пользователя.
При этом результате это показывает, запрашивала ли вызывающая сторона silent-поведение явно. - Политика ключа или устройства, требующая согласия, ввода PIN, биометрической проверки или выбора сертификата
Перенесите интерактивную работу в пользовательский сеанс либо используйте политику ключа для unattended-нагрузки.
При этом результате это отделяет отмену от сбоя поставщика или ключа.
Сопоставьте сбой с изменениями состояния
Для NTE_UI_REQUIRED, сопоставьте последнюю успешную операцию с установкой или обновлением поставщика, созданием или обновлением ключа, изменениями профиля или сеанса, подключением и отключением устройства, обновлением политик и первым неудачным вызовом. При обязательном взаимодействии порядок важен: ошибка сразу после миграции ключа указывает на другую границу, чем сбой после смены учётной записи службы.
- Для этого результата подготовьте минимальный пример с именем API, поставщика, ключа или контейнера, флагами и размерами нечувствительных входных данных.
- Для этого пути сохраните события поставщика, устройства, профиля и ОС за период от последнего успеха до первого сбоя.
- Для этого пути сохраните заведомо исправный контрольный результат с той же идентичностью, архитектурой и выбором поставщика.
Минимальная последовательность теста
Один раз выполните ту же операцию в интерактивном консольном сеансе с разрешённым UI поставщика и один раз — в целевом unattended-контексте, не меняя ключ и поставщика. Разница показывает, пригоден ли объект сам по себе, но ограничен политикой присутствия пользователя.
| Тест | Интерпретация |
|---|---|
| Тот же ввод, заведомо исправный путь | Для обязательного взаимодействия с пользователем успех переносит внимание на выбранного поставщика, политику, устройство, контекст или состояние транзакции. |
| Заведомо исправный ввод, сбойный путь | Для обязательного взаимодействия с пользователем сбой указывает, что среда или выбранный объект самостоятельно не способны выполнить операцию. |
| Исходный путь после одного изолированного изменения | Для обязательного взаимодействия с пользователем это сравнение показывает, устраняет ли предложенное исправление исходное условие. |
Границы этого HRESULT
NTE_SILENT_CONTEXT дополнительно сообщает, что вызывающая сторона запретила UI. этот результат может возникать всякий раз, когда взаимодействие необходимо по самой природе операции. Автоматизация или подавление окна PIN/согласия не эквивалентны подготовке ключа для unattended-использования. Не ослабляйте политику присутствия пользователя без подтверждения требований безопасности.
Для обязательного взаимодействия с пользователем также сохраняйте исходное числовое значение: соседние константы могут требовать существенно разного восстановления, даже если приложение показывает их все как ошибку аутентификации, сертификата или безопасности.
Критерии закрытия проблемы
Операция должна завершаться в реальном контексте развёртывания с ключом, чья политика взаимодействия соответствует этому контексту, сохраняя запросы пользователя там, где его одобрение входит в проект. Для NTE_UI_REQUIRED, сохраните регрессионный тест с нечувствительными идентификаторами и ожидаемыми результатами, включая один отрицательный контроль, который должен по-прежнему завершаться ошибкой.
Технические ссылки
Для NTE_UI_REQUIRED, эти источники определяют HRESULT и соответствующий интерфейс, протокол или формат данных обязательного взаимодействия с пользователем.
- Открытые спецификации Microsoft: значения HRESULT.
- Microsoft: CNG Key Storage Providers.
- Microsoft: функции хранилища ключей CNG.
Нужно найти другой код? Найти другой код состояния или ошибки.