| Предыдущий | Следующий |
| NTE_NOT_SUPPORTED | NTE_BUFFERS_OVERLAP |
NTE_NO_MORE_ITEMS
В NTE_NO_MORE_ITEMS особенно важна область действия: перечисления поставщика. Перечисление достигло нормального конца, поэтому следующей записи поставщика, ключа, алгоритма или свойства в текущем состоянии нет. Сохраняйте шестнадцатеричное значение 0x8009002A вместе с API, который его вернул, поскольку высокоуровневое ПО может преобразовать его в сообщение, теряющее это различие.
Что именно устанавливает этот код
Для этого результата API перечисления поставщиков и ключей обычно используют состояние продолжения и после последнего элемента возвращают статус конца последовательности. Учитывайте позицию вызова: тот же результат может быть нормальным завершением цикла после успешных элементов либо свидетельствовать, что в выбранной области изначально нет видимых записей.
Что сохранить до изменения состояния
- 1. Поставщик, область, флаги и идентичность, с которыми начато перечисление
Считайте это завершением перечисления, если до него были успешные вызовы. - 2. Все успешно полученные элементы и срок жизни состояния продолжения
Освобождайте состояние перечисления соответствующим API и не используйте его повторно после смены поставщика. - 3. Считает ли вызывающая сторона конец последовательности завершением или повторяемой ошибкой
Если ноль элементов неожиданен, проверьте область, имя поставщика, флаги и идентичность, чьи ключи перечисляются.
Для перечисления поставщика эти данные намеренно не содержат секретов: идентификаторов, длин, имён поставщиков, выбранных политик и переходов состояния обычно достаточно без записи закрытых ключей, паролей, PIN или plaintext.
Сопоставьте сбой с изменениями состояния
Для NTE_NO_MORE_ITEMS, сопоставьте последнюю успешную операцию с установкой или обновлением поставщика, созданием или обновлением ключа, изменениями профиля или сеанса, подключением и отключением устройства, обновлением политик и первым неудачным вызовом. При этом результате порядок важен: ошибка сразу после миграции ключа указывает на другую границу, чем сбой после смены учётной записи службы.
- Для этого результата подготовьте минимальный пример с именем API, поставщика, ключа или контейнера, флагами и размерами нечувствительных входных данных.
- Для этого пути сохраните события поставщика, устройства, профиля и ОС за период от последнего успеха до первого сбоя.
- Для этого пути сохраните заведомо исправный контрольный результат с той же идентичностью, архитектурой и выбором поставщика.
Процедура локализации
Выполните то же перечисление под требуемой идентичностью у поставщика с одним известным тестовым ключом. Убедитесь, что цикл один раз возвращает элемент, один раз достигает конечного статуса и освобождает состояние. Это выявляет циклы повторного старта и устаревшие continuation-данные.
| Тест | Интерпретация |
|---|---|
| Тот же ввод, заведомо исправный путь | Для перечисления поставщика успех переносит внимание на выбранного поставщика, политику, устройство, контекст или состояние транзакции. |
| Заведомо исправный ввод, сбойный путь | Для перечисления поставщика сбой указывает, что среда или выбранный объект самостоятельно не способны выполнить операцию. |
| Исходный путь после одного изолированного изменения | Для перечисления поставщика это сравнение показывает, устраняет ли предложенное исправление исходное условие. |
Типичные ошибочные действия
Этот статус может быть нормальным условием завершения цикла, а не ошибкой, и не должен превращаться в шторм повторов. Не повторяйте конечный вызов без сброса состояния перечисления: это может создать busy loop без новой информации.
Для перечисления поставщика также сохраняйте исходное числовое значение: соседние константы могут требовать существенно разного восстановления, даже если приложение показывает их все как ошибку аутентификации, сертификата или безопасности.
Как доказать работоспособность нужного пути
Вызывающая сторона должна отличать ожидаемый конечный статус от неожиданно пустого результата и освобождать ресурсы перечисления в обоих случаях. Для NTE_NO_MORE_ITEMS, сохраните регрессионный тест с нечувствительными идентификаторами и ожидаемыми результатами, включая один отрицательный контроль, который должен по-прежнему завершаться ошибкой.
Технические ссылки
Для NTE_NO_MORE_ITEMS, эти источники определяют HRESULT и соответствующий интерфейс, протокол или формат данных перечисления поставщика.
- Открытые спецификации Microsoft: значения HRESULT.
- Microsoft: CNG Key Storage Providers.
- Microsoft: функции хранилища ключей CNG.
Нужно найти другой код? Найти другой код состояния или ошибки.