| Предыдущий | Следующий |
| STATUS_RXACT_COMMIT_NECESSARY | STATUS_FILEMARK_DETECTED |
STATUS_NO_MORE_ENTRIES
Перечисление завершено
Этот предупреждающий статус отмечает конец последовательности перечисления. Он не равнозначен неудачному поиску. Например, API перечисления LSA могут вернуть STATUS_NO_MORE_ENTRIES , когда в контексте продолжения больше нет объектов, а некоторые API используют его, когда для запрошенного класса вообще нет совпадающих записей.
Вызывающая сторона должна отличать конец последовательности от ошибки транспорта или доступа. Не повторяйте тот же курсор в плотном цикле: следующему вызову нечего продвигать, пока не изменятся исходные данные или контекст перечисления. Запишите общее число уже полученных элементов, чтобы диагностика отличала пустой результат от успешного завершения после множества страниц.
Что исследовать
- Рассматривайте статус как документированное API конечное условие перечисления.
- Храните общее число возвращённых элементов, чтобы отличить пустой набор от конца заполненного набора.
- Не сбрасывайте курсор и не начинайте заново, если действительно не требуется новое перечисление.
Ссылки
Нужно найти другой код? Найти другой код состояния или ошибки.